AWSシークレット・マネージャでボールト・シークレット資格証明を使用するために必要な前提条件について説明します。

1. AWS Secrets Managerでシークレットを作成し、AWSシークレットARNをコピーします。

   詳細は、AWSシークレット・マネージャを参照してください。

2. Amazonリソース名(ARN)を使用するには、AWS管理の前提条件を実行します。

   詳細は、Amazonリソース名(ARN)を使用するためのAWS管理の前提条件の実行(ARN)を参照してください。

3. AWSプリンシパル認証を有効にして、AWSシークレット・マネージャでシークレットへのアクセスを提供します。

   たとえば、Autonomous Databaseインスタンスで次を実行します:

   BEGIN
       DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(                                     
             provider => 'AWS',
             params =>
                JSON_OBJECT( 
                   'aws_role_arn' value 'arn:aws:iam::123456:role/AWS_ROLE_ARN'));
   END; 
   /

   詳細は、ENABLE_PRINCIPAL_AUTHプロシージャおよびAmazonリソース名(ARN)を使用したAWSリソースへのアクセスについてを参照してください。

4. AWSを設定して、AWSシークレット・マネージャでシークレットにアクセスするためのAmazonリソース名(ARN)の権限を提供します。

   AWSコンソールで、シークレットへの読取りアクセス権をプリンシパル認証資格証明に付与する必要があります。

   1. AWSコンソールでIAMに移動し、Access Managementで「ロール」を選択します。
   2. ロールの選択
   3. 「権限」タブで、「権限の追加」→「インライン・ポリシーの作成」をクリックします。
   4. 「サービス」セクションで、サービスとして「シークレット・マネージャ」を選択します。
   5. 「アクション」セクションで、「読取り」アクセス・レベルを選択します。
   6. 「リソース」セクションで「ARNの追加」をクリックし、シークレットにARNを指定して「追加」→「ポリシーの確認」→ポリシー名を指定→「ポリシーの作成」をクリックします。
   7. 「権限」タブに戻り、インライン・ポリシーがアタッチされていることを確認します。

   詳細は、Amazonリソース名(ARN)を使用したAWSリソースへのアクセスおよびAWSシークレット・マネージャの権限ポリシーの例を参照してください。

資格証明でAWSシークレット・マネージャ・シークレットを使用するステップについて説明します。

1. AWSシークレット・マネージャでシークレットを作成し、インライン・ポリシーを作成して、Autonomous DatabaseがAWSシークレット・マネージャのシークレットにアクセスできるようにします。
   詳細は、AWSシークレット・マネージャを使用してVaultシークレット資格証明を作成するための前提条件を参照してください。
2. DBMS_CLOUD.CREATE_CREDENTIALを使用して、AWSシークレット・マネージャ・シークレットにアクセスするためのボールト・シークレット資格証明を作成します。

   次に例を示します。

   BEGIN DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name      => 'AWS_SECRET_CRED',
       params               => JSON_OBJECT( 
            'username'   value 'access_key',
            'secret_id'  value 'arn:aws:secretsmanager:region:account-ID:secret:secret_name' ));
   END;
   /

   説明:

   • username: 元の資格証明のユーザー名です。任意のタイプのユーザー名/パスワード資格証明のユーザー名にできます。

   • secret_id: ボールト・シークレットAWS ARNです。

   ボールト・シークレット資格証明を作成するには、DBMS_CLOUDパッケージに対するEXECUTE権限が必要です。

   詳細は、CREATE_CREDENTIALプロシージャを参照してください。

3. この資格証明を使用して、クラウド・リソースにアクセスします。

   次に例を示します。

   SELECT count(*) FROM DBMS_CLOUD.LIST_OBJECTS(
        'AWS_SECRET_CRED', 
        'https://s3-us-west-2.amazonaws.com/adb/' );