Key Management Service:クイックスタート：シークレットの作成と管理

環境のセットアップ

1. Java 開発キット (JDK) のインストール

JDK 8 以降をダウンロードしてインストールします。インストールを確認します：

java -version

2. SDK の依存関係の追加

プロジェクトに以下の Maven の依存関係を追加します。Alibaba Cloud SDK V2.0 を使用していることを確認してください。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>kms20160120</artifactId>
  <version>1.2.3</version>
</dependency>

3. アクセス認証情報の作成

この例では、認証に AccessKey ペアを使用します。他の認証方式については、「アクセス認証情報の管理」をご参照ください。

RAM コンソールで RAM ユーザーの AccessKey ペアを作成します。詳細は、「AccessKey ペアの作成」をご参照ください。

RAM ユーザーに、AliyunKMSSecretUserAccess と AliyunKMSCryptoUserAccess のシステムポリシーをアタッチして、必要な権限を付与します。詳細は、「RAM ユーザーへの権限付与」をご参照ください。

KMS は 2 種類のアクセス制御をサポートしています：

• ID ベースのポリシー：RAM ID にポリシーをアタッチして、実行可能な操作を定義します。詳細は、「RAM を使用したアクセス制御の実装」をご参照ください。

• リソースベースのポリシー：KMS リソース (キーとシークレット) に直接ポリシーをアタッチして、誰がアクセスできるかを定義します。詳細は、「キーポリシー」および「シークレットポリシー」をご参照ください。

4. インスタンス CA 証明書のダウンロード

1. [インスタンス] ページで、[ソフトウェアキー管理] または [ハードウェアキー管理] タブをクリックし、ご利用のインスタンスを選択します。

2. インスタンス ID または [操作] 列の [詳細] をクリックします。

3. インスタンス詳細ページで、[インスタンス CA 証明書] の横にある [ダウンロード] をクリックします。

証明書ファイルを保存します。デフォルトでは PrivateKmsCA_kst-******.pem という名前です。

5. VPC エンドポイントの記録

インスタンス詳細ページで、ご利用のインスタンスの Virtual Private Cloud (VPC) エンドポイントをコピーします。

シークレット値の取得

以下の例では、SDK クライアントを初期化し、GetSecretValue を呼び出します。この例では、VPC エンドポイントと CA 証明書を使用して KMS インスタンスに接続します。

コードを実行する前に、ALIBABA_CLOUD_ACCESS_KEY_ID と ALIBABA_CLOUD_ACCESS_KEY_SECRET の環境変数を設定してください。

package com.aliyun.sample;

import com.aliyun.tea.*;

public class Sample {

    /**
     * KMS クライアントを初期化します。
     *
     * endpoint：KMS インスタンスの VPC エンドポイント。
     *           例：kst-hzz65f176a0ogplgq****.cryptoservice.kms.aliyuncs.com
     * ca：      インスタンス詳細ページからダウンロードした CA 証明書の内容。
     */
    public static com.aliyun.kms20160120.Client createClient() throws Exception {
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // 環境変数から認証情報を読み取ります
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.endpoint = "<インスタンスの VPC エンドポイント>";
        config.ca = "<インスタンスの CA 証明書>";
        return new com.aliyun.kms20160120.Client(config);
    }

    public static void main(String[] args_) throws Exception {
        com.aliyun.kms20160120.Client client = Sample.createClient();

        com.aliyun.kms20160120.models.GetSecretValueRequest request =
                new com.aliyun.kms20160120.models.GetSecretValueRequest()
                        .setSecretName("<SecretName>");

        com.aliyun.teautil.models.RuntimeOptions runtime =
                new com.aliyun.teautil.models.RuntimeOptions();

        try {
            client.getSecretValueWithOptions(request, runtime);
        } catch (TeaException error) {
            System.out.println(error.getMessage());
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            System.out.println(error.getMessage());
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }
    }
}

実行前に以下のプレースホルダーを置き換えてください：