適切なプログラムによる認証資格情報を使用して SecretClient を作成し、クライアントを使用して Azure Key Vault からシークレットを取得します。
シークレットの現在のバージョンを取得する
Azure Key Vault でシークレットを取得するには、SecretClient クラスの getSecret メソッドを使用します。
const name = 'mySecret';
const { name, properties, value } = await client.getSecret(secretName);
このメソッドは KeyVaultSecret オブジェクトを 返します。
任意のバージョンのシークレットを取得する
Azure Key Vault で特定のバージョンのシークレットを取得するには、SecretClient クラスの getSecret メソッドを呼び出すときに GetSecretOptions オブジェクトを使用します。 このメソッドは KeyVaultSecret オブジェクトを 返します。
const name = 'mySecret';
const options = {
version: 'd9f2f96f120d4537ba7d82fecd913043'
};
const { name, properties, value } = await client.getSecret(secretName, options);
このメソッドは KeyVaultSecret オブジェクトを 返します。
シークレットのすべてのバージョンを取得する
Azure Key Vault 内のすべてのバージョンのシークレットを取得するには、SecretClient クラスの listPropertiesOfSecretVersions メソッドを使用して、シークレットのバージョンのプロパティの iterable リストを取得します。 これは、バージョンの値を含まない SecretProperties オブジェクトを返します。 バージョンの値が必要な場合は、プロパティで返された バージョン を使用して、 getSecret メソッドでシークレットの値を取得します。
メソッド | 値を返します | プロパティを返す |
---|---|---|
getSecret | イエス | イエス |
シークレットバージョンのプロパティを一覧表示する | いいえ | イエス |
const versions = [];
for await (const secretProperties of client.listPropertiesOfSecretVersions(
secretName
)) {
const { value } = await client.getSecret(secretName, {
version: secretProperties?.version,
});
versions.push({
name: secretName,
version: secretProperties?.version,
value: value,
createdOn: secretProperties?.createdOn,
});
}
無効なシークレットを取得する
次の表を使用して、無効なシークレットでできることについて理解します。
許可 | 許可されていない |
---|---|
シークレットを有効にする プロパティの更新 |
値を取得する |