Key Management Service:AAPを使用したアクセス制御の実装

AAPを使用したアクセス制御の実装

AAPを使用すると、ネットワークアクセスルールを設定できます。 SDKを使用して暗号化操作を実行したり、シークレット値を取得したりする場合は、ネットワークアクセスルールを設定できます。 次の3つのカテゴリがサポートされています。

• プライベート: アプリケーションがKMSインスタンスエンドポイントを使用してキーとシークレットにアクセスする必要がある場合は、このオプションを選択します。

• パブリック: アプリケーションがKMSパブリックエンドポイントを使用してシークレットにアクセスする必要がある場合は、このオプションを選択します。

• VPC: アプリケーションがKMS VPCエンドポイントを使用してシークレットにアクセスする必要がある場合、このオプションを選択します。 このオプションは、KMSインスタンスが中国 (杭州) 、中国 (上海) 、中国 (深セン) 、中国 (張家口) の各リージョンにある場合にのみサポートされます。

例

次の例では、KMSインスタンスSDKを使用して暗号化操作を実行し、秘密値を取得します。

次のコンテンツは、図のAAPの説明を説明しています。

アプリケーションは、192.168.XX.XX.XX IPアドレスを介して、key-hzz660a5e7ensihzs **** およびkey-hzz660a5e8dq4iih6 **** キー、およびkst-hzz660a5c8ac57csp **** KMSインスタンスのtest_01およびtest_02シークレットにアクセスできます。

AAPのクライアントキーを作成すると、ブラウザは自動的にクライアントキーファイルとクライアントキーのパスワードファイルをダウンロードします。 SDKを初期化するときは、clientKeyFilePathとclientKeyPassを設定する必要があります。 clientKeyFilePathは、クライアントキーファイルへのパスを指定します。 clientKeyPassは、クライアントキーのパスワードを指定します。 次のサンプルコードは、KMS Instance SDK for Javaを初期化する方法の例を示しています。 詳細については、「KMSインスタンスSDK For Java」をご参照ください。

import com.aliyun.dkms.gcs.openapi.models.Config;
import com.aliyun.dkms.gcs.sdk.Client;

// The connection protocol. Set the value to https. KMS supports connections only over HTTPS. 
String protocol = "https";
// The endpoint of your KMS instance. Specify the value in the following format: <ID of your KMS instance >.cryptoservice.kms.aliyuncs.com. 
String endpoint = "<your KMS Instance Id>.cryptoservice.kms.aliyuncs.com";

// The client key. 
String clientKeyFilePath = "<your client key file path>";
//String clientKey = "<your client key>";

// The password of the client key file. 
String clientKeyPass = "<your client key password>";

// The certificate authority (CA) certificate of the KMS instance. You can specify the path to the CA certificate file or enter the content of the CA certificate. 
String caCertPath = "<path/to/DKMSInstanceCACertificates>";
//String caCert = "<The DKMS instance CA certificates content>";

Client client = new Client(new Config()
                           .setProtocol(protocol)
                           .setEndpoint(endpoint)
                           .setCaFilePath(caCertPath) // The path to the CA certificate file or the content of the CA certificate. Configure this parameter based on your business requirements. 
                           //.setCa(caCert) // The content of the CA certificate. 
                           .setClientKeyFile(clientKeyFilePath)// The path to the client key file or the content of the client key file. Configure this parameter based on your business requirements. 
                           //.setClientKeyContent(clientKey)// The content of the client key file. 
                           .setPassword(clientKeyPass));

関連ドキュメント

• AAPの作成

• Manage an AAP

• Change a client key