RESTベースのIdentity Awareアプリケーションと接続するためのOCI Serverless Fnの設定

1. Oracle Cloud Infrastructure Consoleにテナンシ管理者でサインオンします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」→「アイデンティティ」→「コンパートメント」を選択します。
3. 「コンパートメントの作成」を選択し、コンパートメントを追加します(たとえば、ocifn_compartment)。コンパートメントの作成の詳細は、コンパートメントを作成するにはを参照してください

1. Oracle Cloud Infrastructure Consoleにテナンシ管理者でサインオンします。
2. ナビゲーションメニューを開き、Networking→Virtual cloud networksを選択します。
3. VCNウィザードの起動を選択して、新しいVCNを作成します。
4. ダイアログで、「インターネット接続性を持つVCNの作成」を選択して、「VCNウィザードの起動」をクリックします。
5. ウィザードで、次の詳細を入力します。
   1. VCN名: VCN名(ocifn_vcnなど)を入力します。
   2. コンパートメント: VCNリソースが作成されるコンパートメント(ocifn_compartmentなど)を入力します。
6. 「次」をクリックして、「作成」をクリックして、VCNおよび関連するネットワーク・リソースを作成します。

1. Oracle Cloud Infrastructure Consoleにテナンシ管理者でサインオンします。
2. ナビゲーション・メニューを開き、「Identity & Security」→「Key Management & Secret Management」を選択します
3. 「ボールトの作成」をクリックします。
4. Vaultが作成されるコンパートメントを選択し、Vaultに名前を付けます。「ボールトの作成」をクリックします。
5. 作成したVaultを開き、「キーの作成」をクリックします。Vaultを作成したのと同じコンパートメントにキーを作成します。キーに名前を付け、「キーの作成」をクリックします。
6. 「リソース」メニューから「シークレット」を選択します。「シークレットの作成」をクリックします。
7. 「シークレットの作成」ページで、コンパートメント、名前および説明の詳細を追加します。「暗号化キー」ドロップダウン・リストから作成したキーを選択します。「手動シークレット生成」オプションを選択し、クライアント・コードとクライアント・シークレットを次のいずれかの形式で「シークレット・コンテンツ」フィールドに入力します。
   1. OAuthベースの認可

      {
        "clientCode": "69b48365-14e2-430a-bd75-171f89c158fa",
        "clientSecret": "*/Z9g:gM*SWWLLCGkQhQg2hdWelAZD82"
      }

      OAuthベースの認可用の認可トークンを作成するサンプル・コードについては、OAuth Authorization - Sample Token Creation Codeを参照してください。
   2. 基本認証

      {
        "username": "69b48365-14e2-430a-bd75-171f89c158fa",
        "password": "*/Z9g:gM*SWWLLCGkQhQg2hdWelAZD82"
      }

      .
   Basic認可用の認可トークンを作成するサンプル・コードについては、「Basic認可- サンプル・トークン作成コード」を参照してください
8. 「シークレットの作成」を選択して変更を保存します。

secretId: "ocid1.vaultsecret.oc1.iad.dyyyyehdl4ggaawnqt47hfj48ltofzkdg6wy5fjne859jg0"
region: "us-ashburn-1"

ALL { resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1..fdfdfege4om6nat7fue56566556qqvj3eesjqhmjaegeiaxa' }

1. Oracle Cloud Infrastructure Consoleにテナンシ管理者でサインオンします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」→「アイデンティティ」→「ポリシー」を選択します。
3. 「ポリシーの作成」を選択し、ポリシーの名前(ocifn_policyなど)を指定して、テナンシのルート・コンパートメントを選択します。
4. 次のようなポリシー・ステートメントを追加します。

   Allow dynamic-group <dynamic-group-name> to read secret-family in tenancy

1. Oracle Cloud Infrastructure Consoleにテナンシ管理者でサインオンします。
2. ナビゲーション・メニューを開き、「アイデンティティとセキュリティ」→「アイデンティティ」→「ポリシー」を選択します。
3. 「ポリシーの作成」を選択し、ポリシーの名前(ocifn_policyなど)を指定して、テナンシのルート・コンパートメントを選択します。
4. ポリシー・ビルダーを使用して、「ポリシー・ユース・ケース」リストから「ファンクション」を選択し、「ユーザーによるファンクションおよびアプリケーションの作成、デプロイおよび管理」テンプレートに基づいてポリシーを設定します。
5. 前に作成したグループ(ocifn_groupおよびocifn_compartment)を選択します。これにより、次のようなポリシー・ステートメントが提供されます。

   Allow group 'Default'/'ocifn_grp' to use cloud-shell in tenancy
   Allow group 'Default'/'ocifn_grp' to manage repos in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read objectstorage-namespaces in tenancy
   Allow group 'Default'/'ocifn_grp' to manage logging-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read metrics in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to manage functions-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use virtual-network-family in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use apm-domains in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to read vaults in compartment ocifn_compartment
   Allow group 'Default'/'ocifn_grp' to use keys in compartment ocifn_compartment
   Allow service faas to use apm-domains in compartment ocifn_compartment
   Allow service faas to read repos in tenancy where request.operation='ListContainerImageSignatures'
   Allow service faas to {KEY_READ} in compartment ocifn_compartment where request.operation='GetKeyVersion'
   Allow service faas to {KEY_VERIFY} in compartment ocifn_compartment where request.operation='Verify'

1. idm-agcs-serverless-getting-started-sample: これは、最小限のコードを持つ基本的でわかりやすいサンプルであり、関数の動作を示します。このユース・ケースは、単一アプリケーションをGeneric RESTコネクタと統合し、構成を最小限に抑える必要があるお客様に最適です。初期設定は、Oracle Identity Cloud Service (IDCS)アプリケーションを使用します。このファンクションを構成およびデプロイする詳細なステップは、このディレクトリ内の`README.md`ファイルを参照してください。
2. idm-agcs-serverless-IDCS-application-sample: このサンプルでは、最小限の構成でIDCSアプリケーションの例に焦点を当てています。この機能には、将来、さらにアプリケーションを追加するフレームワークが含まれています。構成およびデプロイメントのステップの詳細は、このディレクトリにある`README.md`ファイルを参照してください。
3. idm-agcs-serverless-azuread-application-sample: このサンプルは、最小限の構成でAzureADアプリケーションの例を必要とするお客様を対象としています。この機能には、将来、さらにアプリケーションを追加するフレームワークが含まれています。このファンクションを構成およびデプロイする詳細なステップは、このディレクトリ内の`README.md`ファイルで確認できます。
4. idm-agcs-serverless-multi-application-sample: このサンプルは、最小限の構成でIDCSとAzureADアプリケーションの両方のサンプルを必要とするお客様を対象としています。この機能には、将来、さらにアプリケーションを追加するフレームワークが含まれています。このディレクトリの`README.md`ファイルには、このファンクションを構成およびデプロイするために必要なすべてのステップが用意されています。

1. 次に示す例に従って、テストを開発します。
   grc-test-infraサンプルテスト

   package com.oracle.idm.agcs.grc.fn.test.infra;
    
   public class RequestResponseTemplateValidationTest {
    
       public void validateSearchUserAsIdentityRequestResponseTemplate() throws IOException, URISyntaxException, InterruptedException {
           // Get the configured Request template by passing the connectedSystem Name, entity name, and operation
           RequestTemplateOutput requestTemplate = getRequestTemplateOutput(connectedSystemName, UserAsIdentityEntity, Operation.SEARCH);
            
           // Get the configured Response template by passing the connectedSystem Name, entity name, and operation
           ResponseTemplateOutput responseTemplate = getResponseTemplateOutput(connectedSystemName, UserAsIdentityEntity, Operation.SEARCH);
            
           // Pass the required attributes in the request template by putting them in the attribute map
           HashMap<String, Object> attributesMap = new HashMap<>();
            
           // Call the generic utility method to validate request and response template
           Map<String, Object> lastRecord = processAndValidateRequestAndResponseTemplate(requestTemplate, responseTemplate, attributesMap);
            
           // Retrieve the necessary data from the response for further processing
           userAsIdentityUid = ((ArrayList<String>) lastRecord.get("uid")).get(0);
       }
   }

   • テストの最初の行は、connectedSystemの名前、エンティティ名および操作を渡して、構成されたリクエスト・テンプレートを取得することです。
   • 2行目は、同様のパラメータを使用して構成済のレスポンス・テンプレートを取得します。
   • ユーザーは、属性マップに必須属性を配置して、要求テンプレートで必須属性を渡す必要があります。
   • 次に、ユーザーは汎用ユーティリティ・メソッドprocessAndValidateRequestAndResponseTemplateをコールするだけで、APIを起動し、そのレスポンスを構成済のレスポンス・テンプレートにマップすることで、リクエスト・テンプレートとレスポンス・テンプレートの両方を内部的に検証して正確性を確保できます。
   • 構成されたリクエスト・テンプレートおよびレスポンス・テンプレートが正しく構成されている場合、テストは成功します。正しく構成されていない場合は失敗し、ユーザーは失敗理由を確認してテンプレートを適切に修正できます。

   サンプル・テスト・ファイルは、次の場所にあるサンプル実装にあります。 <SampleBase>/grc-test-infra/src/test/java/com/oracle/idm/agcs/grc/fn/test/infra/RequestResponseTemplateValidationTest.java

2. テストを実行する前に、次の前提条件を追加します。
   1. <SampleBase>/grc-test-infra/src/test/resources/configファイルを環境に応じて次の値で更新します。

      [DEFAULT]
      user=<<USER>>
      fingerprint=<<FINGERPRINT>>
      key_file=<<PEM_FILE_RELATIVE_PATH>>
      tenancy=<<TENANCY>>
      region=<<REGION>>

   2. 使用している環境の次の値で <SampleBase>/grc-test-infra/src/test/resources/config.propertiesファイルを更新します。

      connectedSystemName=<connectedSystemName>

   3. API署名キーの秘密SSHキー(.pemファイル)を次の場所に追加します。

      <SampleBase>/grc-test-infra/src/test/resources/oci_api_key.pem

3. 開発したテストを実行し、関数を構築します。
   1. サンプル実装のfunctionsディレクトリに移動します。
   2. ファンクションのコンパイルおよびパッケージ化

      mvn clean package-DisDevMode=true