@azure/keyvault-keys package

الفصول

CryptographyClient	عميل يستخدم لتنفيذ عمليات التشفير على مفتاح Azure Key vault أو JsonWebKey المحلي.
KeyClient	يوفر KeyClient أساليب لإدارة KeyVaultKey في Azure Key Vault. يدعم العميل إنشاء مفاتيح KeyVaultKeys واستردادها وتحديثها وحذفها وتطهيرها ونسخها احتياطيا واستعادتها وإدراجها. يدعم العميل أيضا سرد DeletedKey ل Azure Key Vault ممكن للحذف المبدئي.

الواجهات

AesCbcDecryptParameters	معلمات فك التشفير لخوارزميات التشفير AES-CBC.
AesCbcEncryptParameters	معلمات التشفير لخوارزميات التشفير AES-CBC.
AesGcmDecryptParameters	معلمات فك التشفير لخوارزميات التشفير AES-GCM.
AesGcmEncryptParameters	معلمات التشفير لخوارزميات التشفير AES-GCM.
BackupKeyOptions	خيارات backupKey(string, BackupKeyOptions).
BeginDeleteKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى beginDeleteKey(string, BeginDeleteKeyOptions)
BeginRecoverDeletedKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى beginRecoverDeletedKey(string, BeginRecoverDeletedKeyOptions)
CreateEcKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى createEcKey(string, CreateEcKeyOptions)
CreateKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى createKey(string, string, CreateKeyOptions)
CreateOctKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى createOctKey(string, CreateOctKeyOptions)
CreateRsaKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى createRsaKey(string, CreateRsaKeyOptions)
CryptographyClientOptions	المعلمات الاختيارية المقبولة من قبل KeyVault's CryptographyClient
CryptographyOptions	واجهة تمثل خيارات أساليب واجهة برمجة تطبيقات التشفير، انتقل إلى تشفير للحصول على مزيد من المعلومات.
DecryptOptions	خيارات decrypt(DecryptParameters, DecryptOptions).
DecryptResult	نتيجة عملية decrypt(DecryptParameters, DecryptOptions).
DeletedKey	واجهة تمثل مفتاح Key Vault محذوف.
EncryptOptions	خيارات encrypt(EncryptParameters, EncryptOptions).
EncryptResult	نتيجة عملية encrypt(EncryptParameters, EncryptOptions).
GetCryptographyClientOptions	خيارات getCryptographyClient.
GetDeletedKeyOptions	خيارات getDeletedKey(string, GetDeletedKeyOptions).
GetKeyAttestationOptions	خيارات getKeyAttestation(string, GetKeyAttestationOptions).
GetKeyOptions	خيارات getKey(string, GetKeyOptions).
GetKeyRotationPolicyOptions	خيارات <xref:KeyClient.getRotationPolicy>
GetRandomBytesOptions	خيارات getRandomBytes
ImportKeyOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى importKey(string, JsonWebKey, ImportKeyOptions)
JsonWebKey	اعتبارا من http://tools.ietf.org/html/draft-ietf-jose-json-web-key-18
KeyAttestation	واجهة تمثل خصائص إثبات المفتاح
KeyClientOptions	المعلمات الاختيارية المقبولة من قبل KeyVault's KeyClient
KeyPollerOptions	واجهة تمثل المعلمات الاختيارية التي يمكن تمريرها إلى beginDeleteKey(string, BeginDeleteKeyOptions)beginRecoverDeletedKey(string, BeginRecoverDeletedKeyOptions)
KeyProperties	واجهة تمثل خصائص KeyVaultKey
KeyReleasePolicy	قواعد النهج التي يمكن بموجبها تصدير مفتاح.
KeyRotationLifetimeAction	إجراء ومشغله المقابل الذي سيتم تنفيذه بواسطة Key Vault على مدى عمر المفتاح.
KeyRotationPolicy	نهج تدوير المفتاح الكامل الذي ينتمي إلى مفتاح.
KeyRotationPolicyProperties	خصائص نهج تدوير المفتاح الذي يمكن للعميل تعيينه لمفتاح معين. يمكنك أيضا إعادة تعيين نهج تدوير المفتاح إلى قيمه الافتراضية عن طريق تعيين lifetimeActions إلى صفيف فارغ.
KeyVaultKey	واجهة تمثل مفتاح Key Vault، باسمه وقيمته KeyProperties.
KeyVaultKeyIdentifier	يمثل المقاطع التي تقوم بإنشاء معرف مفتاح Key Vault.
ListDeletedKeysOptions	واجهة تمثل معلمات اختيارية لعمليات KeyClient المصفحة التي تم تمريرها إلى listDeletedKeys(ListDeletedKeysOptions).
ListPropertiesOfKeyVersionsOptions	واجهة تمثل معلمات اختيارية لعمليات KeyClient المصفحة التي تم تمريرها إلى listPropertiesOfKeyVersions(string, ListPropertiesOfKeyVersionsOptions).
ListPropertiesOfKeysOptions	واجهة تمثل معلمات اختيارية لعمليات KeyClient المصفحة التي تم تمريرها إلى listPropertiesOfKeys(ListPropertiesOfKeysOptions).
PageSettings	واجهة تتعقب إعدادات التكرار المصفح
PagedAsyncIterableIterator	واجهة تسمح بالتكرار غير المتزامن حتى الاكتمال والصفحة.
PollOperationState	يحتوي PollOperationState على قائمة تم إبداء الرأي فيها لأصغر مجموعة من الخصائص اللازمة لتحديد أي مناقصات العمليات طويلة الأمد. بينما تعمل فئة Poller كآلية تحكم محلية لبدء التشغيل والانتظار والإلغاء المحتمل لعملية تشغيل طويلة، توثق PollOperationState حالة عملية التشغيل الطويل البعيد. يجب تحديثه على الأقل عند بدء العملية، ومتى تنتهي، ومتى يتم إلغاؤها. على الرغم من ذلك، يمكن أن يكون للتطبيقات أي عدد آخر من الخصائص التي يمكن تحديثها لأسباب أخرى.
PollerLike	تمثيل تجريدي للمطلع، يهدف إلى عرض الحد الأدنى فقط من واجهة برمجة التطبيقات التي يحتاج المستخدم إلى العمل معها.
PurgeDeletedKeyOptions	خيارات purgeDeletedKey(string, PurgeDeletedKeyOptions).
ReleaseKeyOptions	خيارات releaseKey
ReleaseKeyResult	نتيجة عملية releaseKey .
RestoreKeyBackupOptions	خيارات restoreKeyBackup(Uint8Array, RestoreKeyBackupOptions).
RotateKeyOptions	خيارات rotateKey
RsaDecryptParameters	معلمات فك التشفير لخوارزميات تشفير RSA.
RsaEncryptParameters	معلمات التشفير لخوارزميات تشفير RSA.
SignOptions	خيارات sign(string, Uint8Array, SignOptions).
SignResult	نتيجة عملية sign(string, Uint8Array, SignOptions).
UnwrapKeyOptions	خيارات unwrapKey(KeyWrapAlgorithm, Uint8Array, UnwrapKeyOptions).
UnwrapResult	نتيجة عملية <xref:unwrap>.
UpdateKeyPropertiesOptions	خيارات updateKeyProperties(string, string, UpdateKeyPropertiesOptions).
UpdateKeyRotationPolicyOptions	خيارات updateKeyRotationPolicy
VerifyDataOptions	خيارات verifyData(string, Uint8Array, Uint8Array, VerifyOptions)
VerifyOptions	خيارات verify(string, Uint8Array, Uint8Array, VerifyOptions).
VerifyResult	نتيجة عملية verify(string, Uint8Array, Uint8Array, VerifyOptions).
WrapKeyOptions	خيارات wrapKey(KeyWrapAlgorithm, Uint8Array, WrapKeyOptions).
WrapResult	نتيجة عملية <xref:wrap>.

النوع أسماء مستعارة

AesCbcEncryptionAlgorithm	نوع موحد يمثل جميع خوارزميات تشفير AES-CBC المدعومة.
AesGcmEncryptionAlgorithm	نوع موحد يمثل جميع خوارزميات تشفير AES-GCM المدعومة.
DecryptParameters	نوع يمثل جميع معلمات فك التشفير المدعومة حاليا كما تنطبق على خوارزميات التشفير المختلفة.
DeletionRecoveryLevel	يعكس مستوى استرداد الحذف الساري حاليا للشهادات في المخزن الحالي. إذا كان يحتوي على "قابل للإزالة"، يمكن حذف الشهادة نهائيا من قبل مستخدم متميز؛ وإلا، يمكن للنظام فقط إزالة الشهادة، في نهاية الفاصل الزمني للاحتفاظ. KnownDeletionRecoveryLevel يمكن استخدامها بالتبادل مع DeleteionRecoveryLevel، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة القابلة للإزالة: تشير إلى حالة المخزن التي يكون فيها الحذف عملية لا رجعة فيها، دون إمكانية الاسترداد. يتوافق هذا المستوى مع عدم توفر أي حماية ضد عملية الحذف؛ يتم فقدان البيانات بشكل لا يمكن إصلاحه عند قبول عملية حذف على مستوى الكيان أو أعلى (المخزن ومجموعة الموارد والاشتراك وما إلى ذلك) Recoverable+Purgeable: يشير إلى حالة المخزن التي يكون فيها الحذف قابلا للاسترداد، والذي يسمح أيضا بالحذف الفوري والدائم (أي الإزالة). يضمن هذا المستوى إمكانية استرداد الكيان المحذوف أثناء فترة الاستبقاء (90 يوما)، ما لم يتم طلب عملية إزالة، أو تم إلغاء الاشتراك. النظام حذفه نهائيا بعد 90 يوما، إذا لم يتم استرداده قابل للاسترداد: يشير إلى حالة المخزن التي يكون فيها الحذف قابلا للاسترداد دون إمكانية الحذف الفوري والدائم (أي الإزالة). يضمن هذا المستوى إمكانية استرداد الكيان المحذوف أثناء فترة الاستبقاء (90 يوما) وبينما لا يزال الاشتراك متوفرا. النظام حذفه نهائيا بعد 90 يوما، إذا لم يتم استرداده Recoverable+ProtectedSubscription: يشير إلى حالة المخزن والاشتراك التي يكون فيها الحذف قابلا للاسترداد خلال فترة الاستبقاء (90 يوما)، ولا يسمح بالحذف الفوري والدائم (أي التطهير)، ولا يمكن فيه إلغاء الاشتراك نفسه نهائيا. النظام حذفه نهائيا بعد 90 يوما، إذا لم يتم استرداده CustomizedRecoverable+Purgeable: يشير إلى حالة المخزن التي يكون فيها الحذف قابلا للاسترداد، والذي يسمح أيضا بالحذف الفوري والدائم (أي الإزالة عند 7 <= SoftDeleteRetentionInDays < 90). يضمن هذا المستوى إمكانية استرداد الكيان المحذوف أثناء فترة الاستبقاء، ما لم يتم طلب عملية إزالة، أو تم إلغاء الاشتراك. CustomizedRecoverable : يشير إلى حالة المخزن التي يكون فيها الحذف قابلا للاسترداد دون إمكانية الحذف الفوري والدائم (أي الإزالة عند 7 <= SoftDeleteRetentionInDays < 90). يضمن هذا المستوى إمكانية استرداد الكيان المحذوف أثناء الفاصل الزمني للاستبقاء وبينما لا يزال الاشتراك متوفرا. CustomizedRecoverable+ProtectedSubscription: يشير إلى حالة المخزن والاشتراك التي يكون فيها الحذف قابلا للاسترداد، والحذف الفوري والدائم (أي الإزالة)، ولا يمكن فيه إلغاء الاشتراك نفسه بشكل دائم عند 7 <= SoftDeleteRetentionInDays < 90. يضمن هذا المستوى إمكانية استرداد الكيان المحذوف أثناء فترة الاستبقاء، ويعكس أيضا حقيقة أنه لا يمكن إلغاء الاشتراك نفسه.
EncryptParameters	نوع يمثل جميع معلمات التشفير المدعومة حاليا كما تنطبق على خوارزميات التشفير المختلفة.
EncryptionAlgorithm	خوارزمية تستخدم للتشفير وفك التشفير. يمكن استخدام <xref:KnownJsonWebKeyEncryptionAlgorithm> بالتبادل مع JsonWebKeyEncryptionAlgorithm، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة RSA-OAEP: [غير مستحسن] RSAES باستخدام ترك مساحة التشفير غير المتماثل الأمثل (OAEP)، كما هو موضح في https://tools.ietf.org/html/rfc3447، مع المعلمات الافتراضية المحددة بواسطة RFC 3447 في القسم A.2.1. تستخدم هذه المعلمات الافتراضية دالة تجزئة SHA-1 ووظيفة إنشاء قناع MGF1 مع SHA-1. توصي Microsoft باستخدام خوارزميات RSA_OAEP_256 أو أقوى لتحسين الأمان. لا توصي Microsoft RSA_OAEP، والتي يتم تضمينها فقط للتوافق مع الإصدارات السابقة. يستخدم RSA_OAEP SHA1، الذي يعرف مشاكل التصادم. RSA-OAEP-256: RSAES باستخدام ترك مساحة التشفير غير المتماثل الأمثل مع دالة تجزئة SHA-256 ووظيفة إنشاء قناع MGF1 مع SHA-256. RSA1_5: [غير مستحسن] RSAES-PKCS1-V1_5 تشفير المفتاح، كما هو موضح في https://tools.ietf.org/html/rfc3447. توصي Microsoft باستخدام خوارزميات RSA_OAEP_256 أو أقوى لتحسين الأمان. لا توصي Microsoft RSA_1_5، والتي يتم تضمينها فقط للتوافق مع الإصدارات السابقة. لم تعد معايير التشفير تنظر في RSA مع نظام ترك مساحة PKCS#1 v1.5 آمن للتشفير. A128GCM: AES-GCM 128 بت. A192GCM: AES-GCM 192 بت. A256GCM: AES-GCM 256 بت. A128KW: التفاف مفتاح AES 128 بت. A192KW: التفاف مفتاح AES 192 بت. A256KW: التفاف مفتاح AES 256 بت. A128CBC: 128 بت AES-CBC. A192CBC: 192 بت AES-CBC. A256CBC: 256 بت AES-CBC. A128CBCPAD: AES-CBC 128 بت مع ترك مساحة ل PKCS. A192CBCPAD: AES-CBC 192 بت مع ترك مساحة PKCS. A256CBCPAD: AES-CBC 256 بت مع ترك مساحة ل PKCS. CKM_AES_KEY_WRAP: التفاف مفتاح CKM AES. CKM_AES_KEY_WRAP_PAD: يلتف مفتاح CKM AES مع ترك مساحة.
KeyCurveName	اسم المنحنى الناقص. للحصول على قيم صالحة، راجع JsonWebKeyCurveName. يمكن استخدام <xref:KnownJsonWebKeyCurveName> بالتبادل مع JsonWebKeyCurveName، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة P-256: منحنى القطع الناقص NIST P-256، منحنى AKA SECG SECP256R1. P-384: منحنى القطع الناقص NIST P-384، منحنى AKA SECG SECP384R1. P-521: منحنى القطع الناقص NIST P-521، منحنى AKA SECG SECP521R1. P-256K: المنحنى الناقص SECP256K1 SECG.
KeyExportEncryptionAlgorithm	تعريف قيم KeyEncryptionAlgorithm. KnownKeyExportEncryptionAlgorithm يمكن استخدامها بالتبادل مع KeyEncryptionAlgorithm، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة CKM_RSA_AES_KEY_WRAP RSA_AES_KEY_WRAP_256 RSA_AES_KEY_WRAP_384
KeyOperation	عمليات مفتاح ويب JSON. لمزيد من المعلومات، راجع JsonWebKeyOperation. يمكن استخدام <xref:KnownJsonWebKeyOperation> بالتبادل مع JsonWebKeyOperation، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة تشفير: يشير إلى أنه يمكن استخدام المفتاح للتشفير. فك تشفير: يشير إلى أنه يمكن استخدام المفتاح لفك التشفير. توقيع: يشير إلى أنه يمكن استخدام المفتاح للتوقيع. التحقق من: يشير إلى أنه يمكن استخدام المفتاح للتحقق. wrapKey: يشير إلى أنه يمكن استخدام المفتاح لالتفاف مفتاح آخر. unwrapKey: يشير إلى أنه يمكن استخدام المفتاح لفك مفتاح آخر. استيراد: يشير إلى أنه يمكن استيراد المفتاح أثناء الإنشاء. تصدير: يشير إلى أنه يمكن تصدير المكون الخاص للمفتاح.
KeyRotationPolicyAction	الإجراء الذي سيتم تنفيذه.
KeyType	نوع مفتاح JsonWebKey (kty)، كما هو محدد في https://tools.ietf.org/html/draft-ietf-jose-json-web-algorithms-40. يمكن استخدام <xref:KnownJsonWebKeyType> بالتبادل مع JsonWebKeyType، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة EC: منحنى القطع الناقص. EC-HSM: منحنى القطع الناقص مع مفتاح خاص يتم تخزينه في HSM. RSA : RSA () RSA-HSM: RSA مع مفتاح خاص يتم تخزينه في HSM. oct: تسلسل ثماني (يستخدم لتمثيل المفاتيح المتماثلة) oct-HSM: تسلسل Octet (يستخدم لتمثيل المفاتيح المتماثلة) المخزنة في HSM.
KeyWrapAlgorithm	خوارزميات مدعومة لالتفاف/فك التفاف المفتاح
RsaEncryptionAlgorithm	نوع موحد يمثل جميع خوارزميات تشفير RSA المدعومة.
SignatureAlgorithm	معرف خوارزمية التوقيع/التحقق. لمزيد من المعلومات حول أنواع الخوارزميات المحتملة، راجع JsonWebKeySignatureAlgorithm. يمكن استخدام <xref:KnownJsonWebKeySignatureAlgorithm> بالتبادل مع JsonWebKeySignatureAlgorithm، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة. القيم المعروفة التي تدعمها الخدمة PS256: RSASSA-PSS باستخدام SHA-256 وMGF1 مع SHA-256، كما هو موضح في https://tools.ietf.org/html/rfc7518 PS384: RSASSA-PSS باستخدام SHA-384 وMGF1 مع SHA-384، كما هو موضح في https://tools.ietf.org/html/rfc7518 PS512: RSASSA-PSS باستخدام SHA-512 وMGF1 مع SHA-512، كما هو موضح في https://tools.ietf.org/html/rfc7518 RS256: RSASSA-PKCS1-v1_5 باستخدام SHA-256، كما هو موضح في https://tools.ietf.org/html/rfc7518 RS384: RSASSA-PKCS1-v1_5 باستخدام SHA-384، كما هو موضح في https://tools.ietf.org/html/rfc7518 RS512: RSASSA-PKCS1-v1_5 باستخدام SHA-512، كما هو موضح في https://tools.ietf.org/html/rfc7518 HS256: HMAC باستخدام SHA-256، كما هو موضح في https://tools.ietf.org/html/rfc7518 HS384: HMAC باستخدام SHA-384، كما هو موضح في https://tools.ietf.org/html/rfc7518 HS512: HMAC باستخدام SHA-512، كما هو موضح في https://tools.ietf.org/html/rfc7518 RSNULL: محجوز ES256: ECDSA باستخدام P-256 وSHA-256، كما هو موضح في https://tools.ietf.org/html/rfc7518. ES384: ECDSA باستخدام P-384 وSHA-384، كما هو موضح في https://tools.ietf.org/html/rfc7518 ES512: ECDSA باستخدام P-521 وSHA-512، كما هو موضح في https://tools.ietf.org/html/rfc7518 ES256K: ECDSA باستخدام P-256K وSHA-256، كما هو موضح في https://tools.ietf.org/html/rfc7518

التعدادات

KnownDeletionRecoveryLevel	يعكس مستوى استرداد الحذف الساري حاليا للشهادات في المخزن الحالي. إذا كان يحتوي على "قابل للإزالة"، يمكن حذف الشهادة نهائيا من قبل مستخدم متميز؛ وإلا، يمكن للنظام فقط إزالة الشهادة، في نهاية الفاصل الزمني للاحتفاظ.
KnownEncryptionAlgorithms	خوارزمية تستخدم للتشفير وفك التشفير.
KnownKeyCurveNames	اسم المنحنى الناقص. للحصول على قيم صالحة، راجع JsonWebKeyCurveName.
KnownKeyExportEncryptionAlgorithm	خوارزمية التشفير لاستخدامها لحماية المواد الرئيسية المصدرة
KnownKeyOperations	القيم المعروفة KeyOperation التي تقبلها الخدمة.
KnownKeyTypes	نوع مفتاح JsonWebKey (kty)، كما هو محدد في https://tools.ietf.org/html/draft-ietf-jose-json-web-algorithms-40.
KnownSignatureAlgorithms	معرف خوارزمية التوقيع/التحقق. لمزيد من المعلومات حول أنواع الخوارزميات المحتملة، راجع JsonWebKeySignatureAlgorithm.

الوظائف

parseKeyVaultKeyIdentifier(string)

تحليل معرف مفتاح Key Vault المحدد. مثال على ذلك:

https://.vault.azure.net/keys//

عند تحليل المعرف أعلاه، ترجع هذه الدالة:

  {
     sourceId: "https://<keyvault-name>.vault.azure.net/keys/<key-name>/<unique-version-id>",
     vaultUrl: "https://<keyvault-name>.vault.azure.net",
     version: "<unique-version-id>",
     name: "<key-name>"
  }

تفاصيل الوظيفة

parseKeyVaultKeyIdentifier(string)

تحليل معرف مفتاح Key Vault المحدد. مثال على ذلك:

https://.vault.azure.net/keys//

عند تحليل المعرف أعلاه، ترجع هذه الدالة:

  {
     sourceId: "https://<keyvault-name>.vault.azure.net/keys/<key-name>/<unique-version-id>",
     vaultUrl: "https://<keyvault-name>.vault.azure.net",
     version: "<unique-version-id>",
     name: "<key-name>"
  }

function parseKeyVaultKeyIdentifier(id: string): KeyVaultKeyIdentifier

المعلمات

id: string

معرف مفتاح Key Vault.

المرتجعات

KeyVaultKeyIdentifier

مشاركة عبر

@azure/keyvault-keys package

الفصول

الواجهات

النوع أسماء مستعارة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

القيم المعروفة التي تدعمها الخدمة

التعدادات

الوظائف

تفاصيل الوظيفة

parseKeyVaultKeyIdentifier(string)

المعلمات

المرتجعات