@azure/keyvault-keys package

クラス

CryptographyClient

Azure Key Vault キーまたはローカル JsonWebKey に対して暗号化操作を実行するために使用されるクライアント。

KeyClient

KeyClient には、Azure Key Vaultで KeyVaultKey を管理するメソッドが用意されています。 クライアントでは、KeyVaultKeys の作成、取得、更新、削除、消去、バックアップ、復元、一覧表示がサポートされています。 クライアントでは、論理的な削除が有効な Azure Key Vaultの DeletedKey の一覧表示もサポートされています。

インターフェイス

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 の CryptographyClient で受け入れられる省略可能なパラメーター

CryptographyOptions

暗号化 API メソッドのオプションを表すインターフェイスは、 CryptographyClient に移動して詳細を確認してください。

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)オプション。

GetKeyOptions

getKey(string, GetKeyOptions)オプション。

GetKeyRotationPolicyOptions

<xref:KeyClient.getRotationPolicy> のオプション

GetRandomBytesOptions

getRandomBytes のオプション

ImportKeyOptions

渡すことができる省略可能なパラメーターを表すインターフェイス importKey(string, JsonWebKey_2, ImportKeyOptions)

JsonWebKey

の時点 http://tools.ietf.org/html/draft-ietf-jose-json-web-key-18

KeyClientOptions

KeyVault の KeyClient で受け入れられる省略可能なパラメーター

KeyPollerOptions

および に渡すことができる省略可能なパラメーターを beginDeleteKey(string, BeginDeleteKeyOptions) 表すインターフェイス beginRecoverDeletedKey(string, BeginRecoverDeletedKeyOptions)

KeyProperties

KeyVaultKey のプロパティを表すインターフェイス

KeyReleasePolicy

キーをエクスポートできるポリシー ルール。

KeyRotationLifetimeAction

キーの有効期間中にKey Vaultによって実行されるアクションとそれに対応するトリガー。

KeyRotationPolicy

キーに属する完全なキー ローテーション ポリシー。

KeyRotationPolicyProperties

特定のキーに対してクライアントが設定できるキー ローテーション ポリシーのプロパティ。

また、lifetimeActions を空の配列に設定することで、キー ローテーション ポリシーを既定値にリセットすることもできます。

KeyVaultKey

名前、値、および KeyProperties を持つKey Vault Key を表すインターフェイス。

KeyVaultKeyIdentifier

Key Vaultキー ID を構成するセグメントを表します。

ListDeletedKeysOptions

に渡される KeyClient ページ操作の省略可能なパラメーターを listDeletedKeys(ListDeletedKeysOptions)表すインターフェイス。

ListPropertiesOfKeyVersionsOptions

に渡される KeyClient ページ操作の省略可能なパラメーターを listPropertiesOfKeyVersions(string, ListPropertiesOfKeyVersionsOptions)表すインターフェイス。

ListPropertiesOfKeysOptions

に渡される KeyClient ページ操作の省略可能なパラメーターを listPropertiesOfKeys(ListPropertiesOfKeysOptions)表すインターフェイス。

PageSettings

ページングされたイテレーションの設定を追跡するインターフェイス

PagedAsyncIterableIterator

完了とページごとの両方の非同期反復を可能にするインターフェイス。

PollOperationState

PollOperationState には、実行時間の長い操作ポーリングツールを定義するために必要なプロパティの最小セットの一覧が含まれています。

Poller クラスは、実行時間の長い操作のトリガー、待機、取り消しを開始するローカル制御メカニズムとして機能しますが、PollOperationState はリモートの実行時間の長い操作の状態を文書化します。

少なくとも操作の開始時、完了時、取り消し時に更新する必要があります。 ただし、実装には、他の理由で更新できる他の数のプロパティを含めることができます。

PollerLike

ユーザーが操作する必要がある最小限の API のみを公開することを目的としたポーリングャーの抽象的な表現。

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

DeletionRecoveryLevel の値を定義します。
KnownDeletionRecoveryLevel は、DeletionRecoveryLevel と同じ意味で使用できます。この列挙型には、サービスがサポートする既知の値が含まれています。

サービスでサポートされている既知の値

消去可能: 削除が元に戻せない操作であり、復旧の可能性がないコンテナーの状態を示します。 このレベルは、Delete 操作に対して使用できる保護に対応しません。エンティティ レベル以上 (コンテナー、リソース グループ、サブスクリプションなど) で Delete 操作を受け入れると、データが回復不能に失われます。
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

JsonWebKeyEncryptionAlgorithm の値を定義します。
<xref:KnownJsonWebKeyEncryptionAlgorithm> JsonWebKeyEncryptionAlgorithm と同じ意味で使用できます。この列挙型には、サービスがサポートする既知の値が含まれています。

サービスでサポートされている既知の値

RSA-OAEP
RSA-OAEP-256
RSA1_5
A128GCM
A192GCM
A256GCM
A128KW
A192KW
A256KW
A128CBC
A192CBC
A256CBC
A128CBCPAD
A192CBCPAD
A256CBCPAD

KeyCurveName

JsonWebKeyCurveName の値を定義します。
<xref:KnownJsonWebKeyCurveName> JsonWebKeyCurveName と同じ意味で使用できます。この列挙型には、サービスでサポートされている既知の値が含まれています。

サービスでサポートされている既知の値

P-256: NIST P-256 楕円曲線、別名 SECG 曲線 SECP256R1。
P-384: NIST P-384 楕円曲線、別名 SECG 曲線 SECP384R1。
P-521: NIST P-521 楕円曲線、別名 SECG 曲線 SECP521R1。
P-256K: SECG SECP256K1 楕円曲線。

KeyExportEncryptionAlgorithm

KeyEncryptionAlgorithm の値を定義します。 KnownKeyExportEncryptionAlgorithm は KeyEncryptionAlgorithm と同じ意味で使用できます。この列挙型には、サービスがサポートする既知の値が含まれています。

サービスでサポートされている既知の値

CKM_RSA_AES_KEY_WRAP
RSA_AES_KEY_WRAP_256
RSA_AES_KEY_WRAP_384

KeyOperation

JsonWebKeyOperation の値を定義します。
<xref:KnownJsonWebKeyOperation> JsonWebKeyOperation と同じ意味で使用できます。この列挙型には、サービスでサポートされている既知の値が含まれています。

サービスでサポートされている既知の値

encrypt
復号化
sign
verify
wrapKey
unwrapKey
import
export

KeyRotationPolicyAction

実行されるアクション。

KeyType

JsonWebKeyType の値を定義します。
<xref:KnownJsonWebKeyType> JsonWebKeyType と同じ意味で使用できます。この列挙型には、サービスでサポートされている既知の値が含まれています。

サービスでサポートされている既知の値

EC: 楕円曲線。
EC-HSM: HSM に格納されている秘密キーを持つ楕円曲線。
RSA: RSA (https://tools.ietf.org/html/rfc3447)
RSA-HSM: HSM に格納されている秘密キーを持つ RSA。
oct: オクテット シーケンス (対称キーを表すために使用)
oct-HSM: HSM に格納されているオクテット シーケンス (対称キーを表すために使用されます)。

KeyWrapAlgorithm

キーの折り返し/ラップ解除でサポートされているアルゴリズム

RsaEncryptionAlgorithm

サポートされているすべての RSA 暗号化アルゴリズムを表す共用体の種類。

SignatureAlgorithm

JsonWebKeySignatureAlgorithm の値を定義します。
<xref:KnownJsonWebKeySignatureAlgorithm> JsonWebKeySignatureAlgorithm と同じ意味で使用できます。この列挙型には、サービスでサポートされている既知の値が含まれています。

サービスでサポートされている既知の値

PS256: SHA-256 および MGF1 と SHA-256 を使用した RSASSA-PSS (以下を参照) https://tools.ietf.org/html/rfc7518
PS384: SHA-384 と MGF1 を使用した RSASSA-PSS (SHA-384 を使用) https://tools.ietf.org/html/rfc7518
PS512: SHA-512 と MGF1 を使用した RSASSA-PSS (SHA-512 を使用) https://tools.ietf.org/html/rfc7518
RS256: SHA-256 を使用した RSASSA-PKCS1-v1_5 (以下を参照) https://tools.ietf.org/html/rfc7518
RS384: SHA-384 を使用した RSASSA-PKCS1-v1_5 (以下を参照) https://tools.ietf.org/html/rfc7518
RS512: SHA-512 を使用した RSASSA-PKCS1-v1_5 (以下を参照) https://tools.ietf.org/html/rfc7518
RSNULL: 予約済み
ES256: で説明されているように、P-256 と SHA-256 を使用した https://tools.ietf.org/html/rfc7518ECDSA。
ES384: P-384 および SHA-384 を使用した ECDSA (以下を参照) https://tools.ietf.org/html/rfc7518
ES512: P-521 および SHA-512 を使用した ECDSA (以下を参照) https://tools.ietf.org/html/rfc7518
ES256K: P-256K と SHA-256 を使用した ECDSA (以下を参照) https://tools.ietf.org/html/rfc7518

列挙型

KnownDeletionRecoveryLevel

サービスが受け入れる DeletionRecoveryLevel の既知の値。

KnownEncryptionAlgorithms

サービスが受け入れる EncryptionAlgorithm の既知の値。

KnownKeyCurveNames

サービスが受け入れる の <xref:JsonWebKeyCurveName> 既知の値。

KnownKeyExportEncryptionAlgorithm

サービスが受け入れる KeyExportEncryptionAlgorithm の既知の値。

KnownKeyOperations

サービスが受け入れる KeyOperation の既知の値。

KnownKeyTypes

サービスが受け入れる の <xref:JsonWebKeyType> 既知の値。

KnownSignatureAlgorithms

サービスが受け入れる の <xref:JsonWebKeySignatureAlgorithm> 既知の値。

機能

parseKeyVaultKeyIdentifier(string)

指定したKey Vaultキー ID を解析します。例を次に示します。

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

上記の ID を解析すると、この関数は次を返します。

  {
     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キー ID を解析します。例を次に示します。

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

上記の ID を解析すると、この関数は次を返します。

  {
     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 キーの ID。

戻り値