Partilhar via


@azure/keyvault-keys package

Classes

CryptographyClient

Um cliente usado para executar operações criptográficas em uma chave de cofre da Chave do Azure ou em um <xref:JsonWebKey>local.

KeyClient

O KeyClient fornece métodos para gerenciar <xref:KeyVaultKey> no Cofre da Chave do Azure. O cliente suporta a criação, recuperação, atualização, exclusão, limpeza, backup, restauração e listagem KeyVaultKeys. O cliente também oferece suporte à listagem de <xref:DeletedKey> para um Cofre de Chaves do Azure habilitado para exclusão suave.

Interfaces

AesCbcDecryptParameters

Parâmetros de desencriptação para algoritmos de encriptação AES-CBC.

AesCbcEncryptParameters

Parâmetros de encriptação para algoritmos de encriptação AES-CBC.

AesGcmDecryptParameters

Parâmetros de desencriptação para algoritmos de encriptação AES-GCM.

AesGcmEncryptParameters

Parâmetros de encriptação para algoritmos de encriptação AES-GCM.

BackupKeyOptions

Opções para <xref:backupKey>.

BeginDeleteKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginDeleteKey>

BeginRecoverDeletedKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginRecoverDeletedKey>

CreateEcKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:createEcKey>

CreateKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:createKey>

CreateOctKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:createOctKey>

CreateRsaKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:createRsaKey>

CryptographyClientOptions

Os parâmetros opcionais aceitos pelo CryptographyClient do KeyVault

CryptographyOptions

Uma interface que representa as opções dos métodos de API de criptografia, vá para o <xref:CryptographyClient> para obter mais informações.

DecryptOptions

Opções para <xref:decrypt>.

DecryptResult

Resultado da operação <xref:decrypt>.

DeletedKey

Uma interface que representa uma chave de cofre de chave excluída.

EncryptOptions

Opções para <xref:encrypt>.

EncryptResult

Resultado da operação <xref:encrypt>.

GetDeletedKeyOptions

Opções para <xref:getDeletedKey>.

GetKeyOptions

Opções para <xref:getKey>.

ImportKeyOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:importKey>

JsonWebKey

A partir de http://tools.ietf.org/html/draft-ietf-jose-json-web-key-18

KeyClientOptions

Os parâmetros opcionais aceitos pelo KeyClient do KeyVault

KeyPollerOptions

Uma interface que representa os parâmetros opcionais que podem ser passados para <xref:beginDeleteKey> e <xref:beginRecoverDeletedKey>

KeyProperties

Uma interface que representa as propriedades de <xref:KeyVaultKey>

KeyVaultKey

Uma interface que representa uma chave do cofre da chave, com seu nome, valor e <xref:KeyProperties>.

KeyVaultKeyIdentifier

Representa os segmentos que compõem um ID de Chave do Cofre da Chave.

ListDeletedKeysOptions

Uma interface que representa parâmetros opcionais para operações paginadas KeyClient passadas para <xref:listDeletedKeys>.

ListPropertiesOfKeyVersionsOptions

Uma interface que representa parâmetros opcionais para operações paginadas KeyClient passadas para <xref:listPropertiesOfKeyVersions>.

ListPropertiesOfKeysOptions

Uma interface que representa parâmetros opcionais para operações paginadas KeyClient passadas para <xref:listPropertiesOfKeys>.

PurgeDeletedKeyOptions

Opções para <xref:purgeDeletedKey>.

RestoreKeyBackupOptions

Opções para <xref:restoreKeyBackup>.

RsaDecryptParameters

Parâmetros de desencriptação para algoritmos de encriptação RSA.

RsaEncryptParameters

Parâmetros de encriptação para algoritmos de encriptação RSA.

SignOptions

Opções para <xref:sign>.

SignResult

Resultado da operação <xref:sign>.

UnwrapKeyOptions

Opções para <xref:unwrapKey>.

UnwrapResult

Resultado da operação <xref:unwrap>.

UpdateKeyPropertiesOptions

Opções para <xref:updateKeyProperties>.

VerifyDataOptions

Opções para <xref:verifyData>

VerifyOptions

Opções para <xref:verify>.

VerifyResult

Resultado da operação <xref:verify>.

WrapKeyOptions

Opções para <xref:wrapKey>.

WrapResult

Resultado da operação <xref:wrap>.

Aliases de Tipo

AesCbcEncryptionAlgorithm

Um tipo de união que representa todos os algoritmos de encriptação AES-CBC suportados.

AesGcmEncryptionAlgorithm

Um tipo de união que representa todos os algoritmos de encriptação AES-GCM suportados.

DecryptParameters

Um tipo que representa todos os parâmetros de desencriptação atualmente suportados à medida que se aplicam a diferentes algoritmos de encriptação.

DeletionRecoveryLevel

Define valores para DeletionRecoveryLevel.
<xref:KnownDeletionRecoveryLevel> pode ser usado de forma intercambiável com DeletionRecoveryLevel, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

Purgeable: Indica um estado vault no qual a exclusão é uma operação irreversível, sem a possibilidade de recuperação. Este nível corresponde a nenhuma proteção disponível contra uma operação Delete; os dados são irremediavelmente perdidos ao aceitar uma operação de Exclusão no nível da entidade ou superior (cofre, grupo de recursos, assinatura, etc.)
Recoverable+Purgeable: Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, purga). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias), a menos que uma operação de limpeza seja solicitada ou a assinatura seja cancelada. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
recuperável : Indica um estado vault no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, purga). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção (90 dias) e enquanto a assinatura ainda estiver disponível. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
Recoverable+ProtectedSubscription: indica um estado de cofre e assinatura no qual a exclusão é recuperável dentro do intervalo de retenção (90 dias), a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente. O sistema irá excluí-lo permanentemente após 90 dias, se não for recuperado
CustomizedRecoverable+Purgeable: Indica um estado vault no qual a exclusão é recuperável e que também permite a exclusão imediata e permanente (ou seja, purga quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção, a menos que uma operação Purge seja solicitada ou a assinatura seja cancelada.
CustomizedRecoverable: Indica um estado de cofre no qual a exclusão é recuperável sem a possibilidade de exclusão imediata e permanente (ou seja, limpeza quando 7<= SoftDeleteRetentionInDays < 90). Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e enquanto a assinatura ainda estiver disponível.
CustomizedRecoverable+ProtectedSubscription: Indica um estado de cofre e assinatura no qual a exclusão é recuperável, a exclusão imediata e permanente (ou seja, limpeza) não é permitida e na qual a assinatura em si não pode ser cancelada permanentemente quando 7<= SoftDeleteRetentionInDays < 90. Esse nível garante a capacidade de recuperação da entidade excluída durante o intervalo de retenção e também reflete o fato de que a assinatura em si não pode ser cancelada.

EncryptParameters

Um tipo que representa todos os parâmetros de encriptação atualmente suportados à medida que se aplicam a diferentes algoritmos de encriptação.

EncryptionAlgorithm

Define valores para JsonWebKeyEncryptionAlgorithm.
<xref:KnownJsonWebKeyEncryptionAlgorithm> pode ser usado de forma intercambiável com JsonWebKeyEncryptionAlgorithm, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

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

KeyCurveName

Define valores para JsonWebKeyCurveName.
<xref:KnownJsonWebKeyCurveName> pode ser usado de forma intercambiável com JsonWebKeyCurveName, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

P-256: A curva elíptica NIST P-256, AKA curva SECG SECP256R1.
P-384: A curva elíptica NIST P-384, AKA SECG curva SECP384R1.
P-521: A curva elíptica NIST P-521, AKA SECG curva SECP521R1.
P-256K: A curva elíptica SECG SECP256K1.

KeyOperation

Define valores para JsonWebKeyOperation.
<xref:KnownJsonWebKeyOperation> pode ser usado de forma intercambiável com JsonWebKeyOperation, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

criptografar
desencriptar
assinar
verificar
wrapKey
unwrapKey
importar

KeyType

Define valores para JsonWebKeyType.
<xref:KnownJsonWebKeyType> pode ser usado de forma intercambiável com JsonWebKeyType, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

EC: Curva Elíptica.
EC-HSM: Curva elíptica com uma chave privada que não é exportável do HSM.
RSA: RSA (https://tools.ietf.org/html/rfc3447)
RSA-HSM: RSA com uma chave privada que não é exportável do HSM.
out: Sequência Octet (usada para representar chaves simétricas)
oct-HSM : Sequência Octet (usada para representar chaves simétricas) que não é exportável do HSM.

KeyWrapAlgorithm

Algoritmos suportados para empacotamento/desempacotamento de chaves

RsaEncryptionAlgorithm

Um tipo de união que representa todos os algoritmos de encriptação RSA suportados.

SignatureAlgorithm

Define valores para JsonWebKeySignatureAlgorithm.
<xref:KnownJsonWebKeySignatureAlgorithm> pode ser usado de forma intercambiável com JsonWebKeySignatureAlgorithm, este enum contém os valores conhecidos que o serviço suporta.

Conheça os valores suportados pelo serviço

PS256: RSASSA-PSS usando SHA-256 e MGF1 com SHA-256, conforme descrito em https://tools.ietf.org/html/rfc7518
PS384: RSASSA-PSS usando SHA-384 e MGF1 com SHA-384, conforme descrito em https://tools.ietf.org/html/rfc7518
PS512: RSASSA-PSS usando SHA-512 e MGF1 com SHA-512, conforme descrito em https://tools.ietf.org/html/rfc7518
RS256: RSASSA-PKCS1-v1_5 usando SHA-256, conforme descrito em https://tools.ietf.org/html/rfc7518
RS384: RSASSA-PKCS1-v1_5 usando SHA-384, conforme descrito em https://tools.ietf.org/html/rfc7518
RS512: RSASSA-PKCS1-v1_5 usando SHA-512, conforme descrito no https://tools.ietf.org/html/rfc7518
RSNULL: Reservado
ES256: ECDSA usando P-256 e SHA-256, conforme descrito em https://tools.ietf.org/html/rfc7518.
ES384: ECDSA usando P-384 e SHA-384, conforme descrito em https://tools.ietf.org/html/rfc7518
ES512: ECDSA usando P-521 e SHA-512, conforme descrito em https://tools.ietf.org/html/rfc7518
ES256K: ECDSA usando P-256K e SHA-256, conforme descrito no https://tools.ietf.org/html/rfc7518

Enumerações

KnownDeletionRecoveryLevel

Valores conhecidos de <xref:DeletionRecoveryLevel> que o serviço aceita.

KnownEncryptionAlgorithms

Valores conhecidos de <xref:JsonWebKeyEncryptionAlgorithm> que o serviço aceita.

KnownKeyCurveNames

Valores conhecidos de <xref:JsonWebKeyCurveName> que o serviço aceita.

KnownKeyOperations

Valores conhecidos de <xref:JsonWebKeyOperation> que o serviço aceita.

KnownKeyTypes

Valores conhecidos de <xref:JsonWebKeyType> que o serviço aceita.

KnownSignatureAlgorithms

Valores conhecidos de <xref:JsonWebKeySignatureAlgorithm> que o serviço aceita.

Funções

parseKeyVaultKeyIdentifier(string)

Analisa o ID da chave do cofre da chave fornecido. Um exemplo é: https://< keyvault-name.vault.azure.net/keys/>< key-name>/<unique-version-id>

Ao analisar o ID acima, essa função retorna:

  {
     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>"
  }

Detalhes de Função

parseKeyVaultKeyIdentifier(string)

Analisa o ID da chave do cofre da chave fornecido. Um exemplo é: https://< keyvault-name.vault.azure.net/keys/>< key-name>/<unique-version-id>

Ao analisar o ID acima, essa função retorna:

  {
     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)

Parâmetros

id

string

O id da chave do cofre da chave.

Devoluções