ロールベースのアクセス・コントロールの手動構成

Oracle Cloud InfrastructureでJSON Web Token (JWT)カスタム・クレームを使用してロールベースのアクセス制御(RBAC)を構成できます。

JWTカスタム・クレームでRBACを許可するドメイン統合アプリケーションを作成するには: 各ステップについては、以降のセクションで詳しく説明します。
ノート

このドキュメントでは、説明のためにOracle Cloud InfrastructureのDefaultドメインを使用します。

ユーザーに対するカスタム属性の作成

ユーザー・エンティティは、そのプロパティおよびその他の情報を属性として格納します。たとえば、名、姓、ユーザー・ログイン、パスワードなどです。Oracle Cloud Infrastructureでカスタム属性を作成できます。

次に、ドメイン内の各ユーザーに割り当てられたロールを格納するカスタム・ユーザー属性を定義する例を示します。
  1. ハンバーガー・メニューをクリックし、「アイデンティティとセキュリティ」に移動して「ドメイン」を選択します。「名前」で、「デフォルト」ドメインをクリックします。
  2. 「スキーマ管理」タブに移動し、「ユーザー属性」を選択します。

  3. 「属性の追加」をクリックし、次を指定します:
    • 表示名: ORDS RBAC
    • 名前:rbac_ords
    • 説明:ORDSのロール・ベースのアクセス制御
    • データ型: 文字列配列

    フィールドの先頭をデフォルトの状態のままにできます。



    「追加」をクリックします。カスタム属性を追加しました。

  4. 検索フィールドに「カスタム」と入力して、新しく追加した属性を検索します。リストにORDS RBAC属性が表示されます。

    「属性の編集」をクリックします。

  5. FQN (完全修飾名)の値をコピーしてメモします。

    この例では、FQNurn:ietf:params:scim:schemas:idcs:extension:custom:User:rbac_ordsです。

カスタム・ロールの割当て

カスタム・ユーザー属性を作成したら、その属性フィールド内でカスタム・ロールの割当てに進むことができます。
  1. 「アイデンティティ」「ドメイン」「デフォルト」に移動します。「ユーザー管理」タブをクリックし、表示されるユーザーのリストからユーザー名を選択します。



    「Edit user」をクリックします。「その他の情報」フィールドにスクロールし、「ORDS RBAC」の下にSQL Developer、 SODA Developerと入力します。

    ORDSロールの詳細は、「Oracle REST Data Servicesのユーザー・ロールについて」のこの章を参照してください。



    ロールを追加した後、「変更の保存」をクリックします。

ドメイン統合アプリケーションの作成

サインイン時にJWTトークンを発行するドメイン内の統合アプリケーションを開発します。

  1. 「アイデンティティ」「ドメイン」「デフォルト」に移動します。「統合アプリケーション」タブをクリックし、「アプリケーションの追加」を選択します。
  2. 「機密アプリケーション」をクリックし、「ワークフローの起動」を選択します。
  3. 「機密アプリケーションの追加」ダイアログで、次のフィールドを指定します:
    • 名前: 機密アプリケーションの名前を入力します。たとえば、Spreadsheet-Addin RBACです。
    • 説明: 説明を入力します。たとえば、スプレッドシート・アドイン・ロール・ベースのアクセス制御の統合アプリケーションです。



    「送信」をクリックします。

    新しく追加されたSpreadsheet-Addin RBACアプリケーション・ページが表示されます。

  4. 「Spreadsheet-Addin RBAC」ページの「OAuth構成」タブで、「OAuth構成の編集」をクリックします。



  5. 「リソース・サーバー構成」で、「このアプリケーションをリソース・サーバーとして今すぐ構成」を選択します。
  6. OAuthで保護する必要があるアプリケーションAPIの構成で、アクセス・トークンの有効期限(秒)として「3600」を選択します。
  7. 「プライマリ・オーディエンス」フィールドに、ssaddin/と入力します。
  8. 「スコープの追加」をクリックし、rbac 「スコープ」を追加します。



  9. 「クライアント構成」で、次のフィールドを指定します:
    • 「今すぐこのアプリケーションをクライアントとして構成」を選択します。
    • 「許可される付与タイプ」「暗黙的」を選択します。
    • 「リダイレクトURL」フィールドに、https://static.oracle.com/cdn/spreadsheet/red-4/redirector.htmlと入力します。
    • 「ログアウト後のURL」フィールドに、https://static.oracle.com/cdn/spreadsheet/red-4/redirector.htmlと入力します。



    「送信」をクリックします。
    ノート

    アプリケーションをアクティブ化してください。

カスタム要求の定義

JWT内にユーザー・ロールを含めるには、カスタム・クレームを使用して、最初の項で設定したカスタム属性をJWTにマップする必要があります。

これを実現するには、追加の一時統合アプリケーションを作成し、それを介してカスタム要求を添付する必要があります。

アイデンティティ・ドメイン統合アプリケーションの作成

追加の一時的な統合アプリケーションを作成します。
  1. 「アイデンティティ」「ドメイン」「デフォルト」に移動します。
  2. 「統合アプリケーション」タブをクリックし、「アプリケーションの追加」を選択します。
  3. 「機密アプリケーション」をクリックし、「ワークフローの起動」を選択します。
    • アプリケーションの名前を入力します: アイデンティティ・ドメイン統合アプリケーション
    • 「Description(摘要)」: 「This is a domain integrated application」と入力します。

    「送信」をクリックします。

  4. アイデンティティ・ドメイン統合アプリケーション・ページで、「OAuth構成」タブを選択します。
  5. 「リソース・サーバー構成」「OAuth構成の編集」をクリックします。「OAuth構成の編集」ダイアログで、次のフィールドを指定します:
    • 「クライアント構成」で、デフォルト値「このアプリケーションをクライアントとして今すぐの構成します」を選択します。
    • 「認可」で、「クライアントの資格証明」を選択します。構成のリストアをデフォルトの状態に保ちます。
    • 「アプリケーション・ロールの追加」を選択します。



    • 「アプリケーション・ロールの追加」ダイアログで、「Identity Domain Administrator」をクリックし、「追加」を選択します。



    • アプリケーション・ロールを追加した後、「送信」をクリックします。
    • アプリケーションをアクティブ化します。
      ノート

      統合アプリケーションの「一般情報」セクションの「クライアントID」および「クライアント・シークレット」をノートにとります。



JWTの新規要求の作成

Identity Domain Administratorアプリケーションの新しいアクセス・トークンを取得するには、CLIENT IDCLIENT 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: 123a1234e1234567aa12345a1abcdefg1
  • Client Secret: idcscs-12a1a123-a123-1234-1234-e1a05aabc123
  • Domain URL: https://idcs-a123ab1ab12a4bb99a9aa9ab99aabbb9.identity.oraclecloud.com:443
Bashシェルで次のコードを実行し、それに応じてプレースホルダ値を置き換えます。
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を超える)で構成される出力が表示されます。

ssaddin.roleとして(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_ords
curl -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ログインの有効化

次の手順により、ORDSはJWTベアラー・トークンを検証し、保護されたリソースへのアクセス権を付与できます。
  1. SQLワークシートの「ナビゲータ」タブで、「スキーマ」ドロップダウン・リストからORDS_METADATAを選択します。
  2. 「オブジェクト・タイプ」ドロップダウン・リストからPackagesを選択します。
  3. 「検索」フィールドにORDS_SECURITYと入力します。検索ファンクションは、ORDS_SECURITYで始まるすべてのエントリを取得します。
  4. ORDS_SECURITYパッケージを展開します。



  5. 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」が表示されます。

接続ファイルの作成

  1. 接続を追加するには、「接続」ペインのヘッダーにある「追加」ボタンをクリックします。「新規接続を追加」ダイアログ・ボックスが開きます。

  2. 「新規接続を追加」ダイアログ・ボックスで、次のフィールドを指定します:
    • 接続の名前: 接続の名前を入力します。
    • 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



接続の作成後、このドメインの他のユーザーと共有できます。