使用適當的程式設計驗證認證建立 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 方法來取得秘密版本屬性的可反覆運算清單。 這會傳回 SecretProperties 物件,其不包含版本的值。 如果您想要版本的值,請使用屬性中傳回的 version,以使用 getSecret 方法取得秘密的值。
| 方法 | 傳回值 | 傳回屬性 |
|---|---|---|
| getSecret | Yes | Yes |
| listPropertiesOfSecretVersions | No | Yes |
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,
});
}
取得停用的秘密
使用下表來瞭解您可使用已停用的秘密執行哪些動作。
| 允許 | 不允許 |
|---|---|
| 啟用秘密 更新屬性 |
取得值 |