ロールベースのアクセス・コントロールの手動構成
Oracle Cloud InfrastructureでJSON Web Token (JWT)カスタム・クレームを使用してロールベースのアクセス制御(RBAC)を構成できます。
- ユーザーに対するカスタム属性の作成
- カスタム・ロールの割当て
- ドメイン統合アプリケーションの作成
- カスタム要求の定義
- Autonomous AI DatabaseスキーマのIAMログインの有効化
- 接続ファイルの作成
このドキュメントでは、説明のためにOracle Cloud InfrastructureのDefaultドメインを使用します。
ユーザーに対するカスタム属性の作成
ユーザー・エンティティは、そのプロパティおよびその他の情報を属性として格納します。たとえば、名、姓、ユーザー・ログイン、パスワードなどです。Oracle Cloud Infrastructureでカスタム属性を作成できます。
- ハンバーガー・メニューをクリックし、「アイデンティティとセキュリティ」に移動して「ドメイン」を選択します。「名前」で、「デフォルト」ドメインをクリックします。
- 「スキーマ管理」タブに移動し、「ユーザー属性」を選択します。
- 「属性の追加」をクリックし、次を指定します:
- 表示名: ORDS RBAC
- 名前:rbac_ords
- 説明:ORDSのロール・ベースのアクセス制御
- データ型: 文字列配列
フィールドの先頭をデフォルトの状態のままにできます。
「追加」をクリックします。カスタム属性を追加しました。
- 検索フィールドに「カスタム」と入力して、新しく追加した属性を検索します。リストにORDS RBAC属性が表示されます。
「属性の編集」をクリックします。
- FQN (完全修飾名)の値をコピーしてメモします。
この例では、FQNはurn:ietf:params:scim:schemas:idcs:extension:custom:User:rbac_ordsです。
カスタム・ロールの割当て
- 「アイデンティティ」→「ドメイン」→「デフォルト」に移動します。「ユーザー管理」タブをクリックし、表示されるユーザーのリストからユーザー名を選択します。
「Edit user」をクリックします。「その他の情報」フィールドにスクロールし、「ORDS RBAC」の下にSQL Developer、 SODA Developerと入力します。
ORDSロールの詳細は、「Oracle REST Data Servicesのユーザー・ロールについて」のこの章を参照してください。
ロールを追加した後、「変更の保存」をクリックします。
ドメイン統合アプリケーションの作成
サインイン時にJWTトークンを発行するドメイン内の統合アプリケーションを開発します。
- 「アイデンティティ」→「ドメイン」→「デフォルト」に移動します。「統合アプリケーション」タブをクリックし、「アプリケーションの追加」を選択します。
- 「機密アプリケーション」をクリックし、「ワークフローの起動」を選択します。
- 「機密アプリケーションの追加」ダイアログで、次のフィールドを指定します:
- 名前: 機密アプリケーションの名前を入力します。たとえば、Spreadsheet-Addin RBACです。
- 説明: 説明を入力します。たとえば、スプレッドシート・アドイン・ロール・ベースのアクセス制御の統合アプリケーションです。
「送信」をクリックします。
新しく追加されたSpreadsheet-Addin RBACアプリケーション・ページが表示されます。
- 「Spreadsheet-Addin RBAC」ページの「OAuth構成」タブで、「OAuth構成の編集」をクリックします。
- 「リソース・サーバー構成」で、「このアプリケーションをリソース・サーバーとして今すぐ構成」を選択します。
- OAuthで保護する必要があるアプリケーションAPIの構成で、アクセス・トークンの有効期限(秒)として「3600」を選択します。
- 「プライマリ・オーディエンス」フィールドに、ssaddin/と入力します。
- 「スコープの追加」をクリックし、rbac 「スコープ」を追加します。
- 「クライアント構成」で、次のフィールドを指定します:
- 「今すぐこのアプリケーションをクライアントとして構成」を選択します。
- 「許可される付与タイプ」で「暗黙的」を選択します。
- 「リダイレクトURL」フィールドに、
https://static.oracle.com/cdn/spreadsheet/red-4/redirector.htmlと入力します。 - 「ログアウト後のURL」フィールドに、
https://static.oracle.com/cdn/spreadsheet/red-4/redirector.htmlと入力します。
「送信」をクリックします。ノート
アプリケーションをアクティブ化してください。
カスタム要求の定義
JWT内にユーザー・ロールを含めるには、カスタム・クレームを使用して、最初の項で設定したカスタム属性をJWTにマップする必要があります。
これを実現するには、追加の一時統合アプリケーションを作成し、それを介してカスタム要求を添付する必要があります。
アイデンティティ・ドメイン統合アプリケーションの作成
- 「アイデンティティ」→「ドメイン」→「デフォルト」に移動します。
- 「統合アプリケーション」タブをクリックし、「アプリケーションの追加」を選択します。
- 「機密アプリケーション」をクリックし、「ワークフローの起動」を選択します。
- アプリケーションの名前を入力します: アイデンティティ・ドメイン統合アプリケーション
- 「Description(摘要)」: 「This is a domain integrated application」と入力します。
「送信」をクリックします。
- アイデンティティ・ドメイン統合アプリケーション・ページで、「OAuth構成」タブを選択します。
- 「リソース・サーバー構成」で「OAuth構成の編集」をクリックします。「OAuth構成の編集」ダイアログで、次のフィールドを指定します:
- 「クライアント構成」で、デフォルト値「このアプリケーションをクライアントとして今すぐの構成します」を選択します。
- 「認可」で、「クライアントの資格証明」を選択します。構成のリストアをデフォルトの状態に保ちます。
- 「アプリケーション・ロールの追加」を選択します。
- 「アプリケーション・ロールの追加」ダイアログで、「Identity Domain Administrator」をクリックし、「追加」を選択します。
- アプリケーション・ロールを追加した後、「送信」をクリックします。
- アプリケーションをアクティブ化します。
JWTの新規要求の作成
Identity Domain Administratorアプリケーションの新しいアクセス・トークンを取得するには、CLIENT ID、CLIENT SECRETおよびDOMAIN URLが必要です。
前のステップで作成したドメイン統合アプリケーションのCLIENT IDおよびCLIENT SECRETがあります。
DOMAIN URLは、ドメイン情報のドメイン・ページにあります。
次のコマンドを実行して、(CLIENT ID)、(CLIENT SECRET)および(DOMAIN URL)の値を値に置き換えます。
export ACCESS_TOKEN=$(curl -s -i -u"(CLIENT ID):(CLIENT SECRET)" -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" --request POST (DOMAIN URL)/oauth2/v1/token -d
"grant_type=client_credentials&scope=urn:opc:idm:__myscopes__" | tail -n +1 | grep -o
'"access_token":"[^"]*' | cut -d'"' -f4)Client ID: 123a1234e1234567aa12345a1abcdefg1Client Secret: idcscs-12a1a123-a123-1234-1234-e1a05aabc123Domain URL: https://idcs-a123ab1ab12a4bb99a9aa9ab99aabbb9.identity.oraclecloud.com:443
export ACCESS_TOKEN=$(curl -s -i -u"123a1234e1234567aa12345a1abcdefg1: idcscs-12a1a123-a123-1234-1234-e1a05aabc123" -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" --request POST https://idcs-a123ab1ab12a4bb99a9aa9ab99aabbb9.identity.oraclecloud.com:443/oauth2/v1/token -d "grant_type=client_credentials&scope=urn:opc:idm:__myscopes__" |
tail -n +1 | grep -o '"access_token":"[^"]*' | cut -d'"'
-f4)
echo $ACCESS_TOKEN次の図は、前述のコマンドがBashシェルにどのように表示されるかを示しています。
英数字を含む複数行(10を超える)で構成される出力が表示されます。
(ROLE CLAIM NAME)、urn:ietf:params:scim:schemas:idcs:extension:custom:User.rbac_ordsとして(MODIFIED FQN)を指定して次のコマンドを実行します:
ステップ1のFQNを使用して、最後の「: 」を「: 」に置き換えます。
たとえば、ステップ1のFQNは次のようになります。
urn:ietf:params:scim:schemas:idcs:extension:custom:User:rbac_ordsしたがって、MODIFIED FQNは次のようになります。
urn:ietf:params:scim:schemas:idcs:extension:custom:User.rbac_ordscurl -i -X POST (DOMAIN URL)/admin/v1/CustomClaims -H"Cache-Control: no-cache" -H"Accept:application/json" -H"Content-Type:application/json" -H"Authorization: Bearer $ACCESS_TOKEN" -d '{
"schemas": [
"urn:ietf:params:scim:schemas:oracle:idcs:CustomClaim"
],
"name": "(ROLE CLAIM NAME)",
"value": "$user.(MODIFIED FQN).*",
"expression": true,
"mode": "always",
"tokenType": "AT",
"allScopes": false,
"scopes": [
"ssaddin/rbac"
]
}'Domain URLを、前述のコード内の実際の値に置き換えます。
出力としてHTTP/1.1 201 Createdが表示されます。
Autonomous AI Database SchemaのRBAC IAMログインの有効化
- SQLワークシートの「ナビゲータ」タブで、「スキーマ」ドロップダウン・リストから
ORDS_METADATAを選択します。 - 「オブジェクト・タイプ」ドロップダウン・リストから
Packagesを選択します。 - 「検索」フィールドに
ORDS_SECURITYと入力します。検索ファンクションは、ORDS_SECURITYで始まるすべてのエントリを取得します。 ORDS_SECURITYパッケージを展開します。CREATE_JWT_PROFILEを右クリックし、RUNをクリックします。これにより、RUN CODEダイアログが開きます。「Run Code…」ダイアログで、次のフィールド値を指定します。- P_ISSUER- https://identity.oraclecloud.com/。このフィールドは、null以外の値である必要があり、1つのカンマで入力する必要があります。
- P_AUDIENCE-ssaddin/。このフィールドはnull以外の値である必要があります。
- P_JWK_URL- DOMAIN URLに/admin/v1/SigningCert/jwkを付加します。https:// で始まるNULL以外の値で、認可サーバーによって提供された公開検証キーをJSON Web Key (JWK)形式で指定する必要があります。
OCIコンソールの「アイデンティティとセキュリティ」ナビゲーション・メニューの「ドメイン」メニューにある「ドメイン情報」タブで、「ドメインURL」を表示できます。
- P_DESCRIPTION - このプロファイルの名称を入力します。たとえば、"RBAC JWT Demo confluence"です。
- P_ALLOWED_AGE- 「0」
- P_ALLOWED_SKEW- 「0」
- P_ROLE_CLAIM_NAME- 「ssaddin.role」
「ワークシートにコードを挿入」をクリックします。
プロシージャを実行します。
出力パネルに「PL/SQL procedure successfully completed」が表示されます。
接続ファイルの作成
-
接続を追加するには、「接続」ペインのヘッダーにある「追加」ボタンをクリックします。「新規接続を追加」ダイアログ・ボックスが開きます。
- 「新規接続を追加」ダイアログ・ボックスで、次のフィールドを指定します:
- 接続の名前: 接続の名前を入力します。
- Autonomous DatabaseのURL: 接続先のAutonomous AI DatabaseのURLを入力します。Autonomous AI DatabaseのWeb UIからURL全体をコピーします。たとえば、「https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/」というリンクを入力またはコピーしてデータベースに接続します。
- スキーマ名: Autonomous DatabaseスキーマのIAMログインの有効化に使用するスキーマと同じスキーマを入力します。
- 接続タイプの選択: OCI IAM
- ドメインURL: 「ドメイン情報」タブから「ドメインURL」を入力します。
- 「RBAC」IAMタイプを選択します。
- IAMスコープ:
ssaddin/rbac
接続の作成後、このドメインの他のユーザーと共有できます。
親トピック: IAM認証でのロールベースのアクセス制御の使用


















