カスタムプロビジョニングでロールと権限APIを構成する

miniOrangeダッシュボードから、外部アプリケーションのロールと権限を管理できます。カスタムプロビジョニングアプリケーションでは、ロールの作成、更新、削除、権限の割り当て/割り当て解除、ユーザーへの割り当て/割り当て解除が可能です。

カスタムプロビジョニングアプリケーションを設定し、外部アプリケーションAPIを統合します。カスタムプロビジョニングアプリケーションの追加方法については、ガイドを参照してください。

このガイドは、外部アプリケーションのロールと権限の管理に関連する API を構成するのに役立ちます。

1. 外部アプリをminiOrangeに設定する

miniOrangeでカスタムプロビジョニングアプリケーションを設定するには、こちらのガイド「カスタムプロビジョニングアプリの追加方法」を参照してください。

1.1 インポートロールAPIの設定

この API は、外部アプリケーションの既存のロールをインポートするために使用されます。

• miniOrangeの外部アプリ タブをクリック 設定を追加する.



• 提供する イベント設定名。 選択する イベントの種類 as ロールリクエストのインポート。 追加します GETエンドポイント ロールをインポート/取得します。



• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 属性マッピング:
• マップ ロールデータの主キー APIのレスポンスに含まれるロールキー（これに対応するすべてのロールを取得できます）を指定します。ロールリストがどのフィールドにもマッピングされていない場合は、空白のままにしてください。
• 構成 属性マッピング 個々のロール属性をminiOrange属性にマッピングする ロールID、ロール名, etc.



• 構成 ページネーション設定:
• 設定する ページネーションタイプ ページネーションキー API でサポートされている場合。



• ソフトウェアの制限をクリック 設定を保存.
• に ロールのインポート、をクリックしてください インポートボタン （下矢印）に対応する インポートロール リスト内のイベント miniOrangeの外部アプリ タブには何も表示されないことに注意してください。




1.2 インポート権限APIの設定

この API は、外部アプリケーションで許可された権限をインポートするために使用され、これをロールに追加して、アプリケーション内のユーザーのアクセス レベルを決定できます。

• に行きます miniOrangeの外部アプリ タブ。 クリック 設定を追加する.



• 提供する イベント設定名。 選択する イベントの種類 as インポート権限リクエスト。 追加します GETエンドポイント 権限をインポート/取得します。



• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ページネーション設定:
• 設定する ページネーションタイプ ページネーションキー API でサポートされている場合。



• 構成 属性マッピング 個々の権​​限属性を miniOrange 属性にマッピングします。
• マップ 権限データの主キー 権限キー (これに対応するすべての権限を取得します) が API の応答に含まれます。
• 権限が文字列のリストとして受け取られる場合は、属性を使用します 権限名のリスト.
• 権限がキーと値のペアとして受け取られる場合は、属性を使用する 権限名と権限の説明.



• ソフトウェアの制限をクリック 設定を保存.
• に インポート権限、をクリックしてください インポートボタン （下矢印）に対応する インポート権限 リスト内のイベント miniOrangeの外部アプリ タブには何も表示されないことに注意してください。




1.3 インポートロールと権限の割り当てAPIを構成する

この API は、ロールと権限の割り当てをインポートして、特定のロール下に存在する権限を特定するために使用されます。

• に行きます miniOrangeの外部アプリ タブ。 クリック 設定を追加する.



• 提供する イベント設定名。 選択する イベントの種類 as 役割と権限の割り当てリクエストのインポート。 追加します GETエンドポイント ロールの権限をインポート/取得するには、 外部ロールID エンドポイントで (スペースバー > @ を押して、外部ロール ID を選択)。



• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ページネーション設定:
• 構成 次のページキー (API がデータをバッチで提供する場合)。
• 構成 開始ページ番号 (API がページ区切りをサポートしている場合)。



• 構成 属性マッピング 個々の権​​限属性を miniOrange 属性にマッピングします。
• マップ 権限データの主キー 権限キー (これに対応するすべての権限を取得します) が API の応答に含まれます。
• 権限が文字列のリストとして受け取られる場合は、属性を使用します 権限名のリスト.
• 権限がキーと値のペアとして受け取られる場合は、属性を使用する 権限名 (NAIST) と 権限の説明.



• ソフトウェアの制限をクリック 設定を保存.
• に 役割と権限の割り当てをインポートする、をクリックしてください インポートボタン （下矢印）に対応する インポートロール リスト内のイベント miniOrangeの外部アプリ タブには何も表示されないことに注意してください。

2. miniOrangeを外部アプリAPIに設定する

カスタムプロビジョニングアプリケーションで、「miniOrange to External app」タブに移動します。

2.1 ロール作成APIの設定

この API は、ロールと権限セクションでロールを作成するときに使用されます。

• miniOrangeから外部アプリへ タブをクリック 設定を追加する.



• 提供する イベント設定名。 選択する イベントの種類 as ロールを作成。 追加します POSTエンドポイント 外部アプリケーションにロールを作成します。



• まず Authorization 承認タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ リクエスト本文を追加します。外部アプリのドキュメントから構造を確認してください。本文の属性に対応するminiOrange属性を追加するには、スペースバー > @ > 関連するロール属性を選択します。



• 構成 応答設定 地図を ステータスキー、エラーキー、 (NAIST) と 外部識別子 レスポンスで受信したロールのステータスキーとエラーキー。レスポンスにステータスキーとエラーキーが含まれていない場合は、そのままにしておきます。



• ソフトウェアの制限をクリック 構成の保存.

2.2 ロール更新APIの設定

この API は、ロールと権限セクションでロールを更新するときに使用されます。

• に行きます miniOrangeから外部アプリへ タブをクリックして 設定を追加する.



• 提供する イベント設定名。 選択する イベントの種類 as 役割の更新。 追加します POST/PUTエンドポイント 追加する必要がある 外部ロールID/名前 エンドポイントで (スペースバー > @ を押して、外部ロール ID/名前を選択)。



• まず Authorization 承認タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ リクエスト本文を追加します。本文の属性に対応するロールのminiOrange属性を追加するには、スペースバー > @ > 関連するロール属性を選択します。



• 構成 応答設定 地図を ステータスキー (NAIST) と エラーキー 応答で受信されました。



• ソフトウェアの制限をクリック 構成の保存.

2.3 ロール削除APIの設定

この API は、ロールと権限セクションでロールを削除するときに使用されます。

• に行きます miniOrangeから外部アプリへ タブ。 クリック 設定を追加する.



• 提供する イベント設定名.
• 選択 イベントの種類 as ロールを削除.
• 加えます POST/PUT/DELETEエンドポイント 追加する必要がある 外部ロールID/名前 エンドポイントで (スペースバー > @ を押して、外部ロール ID/名前を選択)。



• まず Authorization 承認タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ 必要に応じてリクエスト本文を追加します。本文の属性に対応するロールのminiOrange属性を追加するには、スペースバー > @ > 関連するロール属性を選択します。
• 構成 応答設定 地図を ステータスキー (NAIST) と エラーキー 応答で受信されました。



• ソフトウェアの制限をクリック 構成の保存.

2.4. ロールへの権限割り当てAPIの設定

この API は、ロールと権限セクションでロールの構成中にロールに権限を割り当てるときに使用されます。

• に行きます miniOrangeから外部アプリへ タブ。 クリック 設定を追加する.



• 提供する イベント設定名.
• 選択 イベントの種類 as ロールに権限を割り当てます。.
• 加えます POST/PUTエンドポイント追加する必要がある 外部ロールID/名前 エンドポイントで (スペースバー > @ を押して、外部ロール ID/名前を選択)。



• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ リクエスト本文を追加します。本文の権限属性に対応するminiOrange属性を追加するには、スペースバー > @ > 該当する権限属性を選択します。
• 権限を文字列のリストとして送信する場合は、属性を使用します。 権限名のリスト.



• 権限をキーと値のペアとして送信する場合は、属性を使用します。 権限名 (NAIST) と 権限の説明.



• 構成 応答設定 地図を ステータスキー (NAIST) と エラーキー 応答で受信されました。



• ソフトウェアの制限をクリック 設定を保存.

2.5 ユーザーへのロールの割り当てAPIの設定

このAPIは、「役割と権限」セクションで役割設定時にグループを役割に割り当てる際に使用されます。割り当てられたグループのユーザーは、外部アプリケーションでその役割に割り当てられます。また、このAPIは、「グループ」 >> 「グループの管理」でユーザーをグループに割り当てる際にもトリガーされます。

• に行きます miniOrangeから外部アプリへ タブ。 クリック 設定を追加する.



• 提供する イベント設定名.
• 選択 イベントの種類 as ユーザーのロールへの割り当て.
• 加えます POST/PUTエンドポイントを追加する必要があります 外部ユーザーID エンドポイントで (スペースバー > @ を押す > 外部ユーザー ID を選択)。




API がエンドポイント自体にロール ID を要求する場合は、エンドポイントを次のように作成します。




• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ リクエスト本文を追加します。本文のロール属性に対応するminiOrange属性を追加するには、スペースバー > @ > 関連するロール属性を選択します。



• 構成 応答設定 地図を ステータスキー (NAIST) と エラーキー 応答で受信されました。



• ソフトウェアの制限をクリック 設定を保存.

2.6 ユーザーAPIからロールの割り当て解除を構成する

このAPIは、[役割と権限]セクションで役割を更新する際に、グループを役割から割り当て解除する際に使用されます。そのグループに属するユーザーは、外部アプリケーションで役割から割り当て解除されます。また、[グループ] >> [グループの管理]でユーザーをグループから割り当て解除する際にも、このAPIがトリガーされます。

• に行きます miniOrangeから外部アプリへ タブ。 クリック 設定を追加する.



• 提供する イベント設定名.
• 選択 イベントの種類 as ユーザーの役割の割り当て解除.
• 加えます POST/PUT/DELETEエンドポイントを追加する必要があります 外部ユーザーID エンドポイントで（スペースバー > @ > 外部ユーザーIDを選択）ロールIDも必要な場合は、同じ方法で追加してください。




API がエンドポイント自体にロール ID を要求する場合は、エンドポイントを次のように作成します。




• まず Authorization これは [承認] タブで設定されます。



• 提供する ヘッダーの API に必要です。



• 構成 ボディ 必要に応じてリクエスト本文を追加します。本文のロール属性に対応するminiOrange属性を追加するには、スペースバー > @ > 該当するロール属性を選択します。



• 構成 応答設定 地図を ステータスキー (NAIST) と エラーキー 応答で受信されました。



• ソフトウェアの制限をクリック 構成の保存.