الحصول على مفتاح في Azure Key Vault باستخدام JavaScript

قم بإنشاء KeyClient باستخدام بيانات اعتماد المصادقة البرمجية المناسبة، ثم استخدم العميل لتعيين مفتاح وتحديثه وتدويره في Azure Key Vault.

الحصول على المفتاح

يمكنك الحصول على أحدث إصدار من مفتاح أو إصدار معين من مفتاح باستخدام أسلوب getKey . يقع الإصدار ضمن خصائص عنصر KeyVaultKey .

• الحصول على أحدث إصدار: await client.getKey(name);
• الحصول على إصدار محدد: await client.getKey(name, { version });

// Azure client libraries
import { DefaultAzureCredential } from '@azure/identity';
import {
    KeyClient,
} from '@azure/keyvault-keys';

// Authenticate to Azure Key Vault
const credential = new DefaultAzureCredential();
const client = new KeyClient(
    `https://${process.env.AZURE_KEYVAULT_NAME}.vault.azure.net`,
    credential
);

const name = `myRsaKey`;

// Get latest key
const latestKey = await client.getKey(name);
console.log(`${latestKey.name} version is ${latestKey.properties.version}`);

// Get previous key by version id
const keyPreviousVersionId = '2f2ec6d43db64d66ad8ffa12489acc8b';
const keyByVersion = await client.getKey(name, {
    version: keyPreviousVersionId
});
console.log(`Previous key version is ${keyByVersion.properties.version}`);

الحصول على جميع إصدارات المفتاح

للحصول على جميع إصدارات المفتاح في Azure Key Vault، استخدم listPropertiesOfKeyVersions أسلوب فئة KeyClient للحصول على قائمة قابلة للتكسير لخصائص إصدار المفتاح. يؤدي هذا إلى إرجاع كائن KeyProperties ، والذي لا يتضمن قيمة الإصدار. إذا كنت تريد قيمة الإصدار، فاستخدم الإصدار الذي تم إرجاعه في الخاصية للحصول على قيمة المفتاح باستخدام أسلوب getKey.

الأسلوب	إرجاع القيمة	إرجاع الخصائص
getKey	‏‏نعم‬	‏‏نعم‬
listPropertiesOfKeyVersions	لا	‏‏نعم‬

// Azure client libraries
import { DefaultAzureCredential } from '@azure/identity';
import {
    KeyClient,
} from '@azure/keyvault-keys';

// Authenticate to Azure Key Vault
const credential = new DefaultAzureCredential();
const client = new KeyClient(
    `https://${process.env.AZURE_KEYVAULT_NAME}.vault.azure.net`,
    credential
);

const name = `myRsaKey`;

for await (const keyProperties of client.listPropertiesOfKeyVersions(name)) {
    const thisVersion = keyProperties.version;
    
    const { key } = await client.getKey(name, {
        version: thisVersion
    });

    // do something with version's key value
}

الحصول على مفتاح معطل

استخدم الجدول التالي لفهم ما يمكنك القيام به باستخدام مفتاح معطل.

مسموح	غير مسموح
تمكين المفتاح تحديث الخصائص.	الحصول على القيمة

الخطوات التالية

• تمكين المفتاح وتعطيله من JavaScript SDK