SubtleCrypto.importKey()

O método SubtleCrypto.importKey() retorna como Promise de uma CryptoKey de uma informção dada como parâmetro.

Sintaxe

var result = crypto.subtle.importKey(format, keyData, algo, extractable, usages);

Parâmetros

• format é um valor enumerado descrevendo o formato de informação da key exportada. Podendo ser um dos seguintes:
  • "raw", a key como um conjunto de bytes, normalmente uma key secreta.
  • "pkcs8" uma key privada, no IETF Public Key-Cryptographic Standard Encryption #8.
  • "spki", normalmente uma key pública, no Simple public key infrastructure padrão.
  • "jwk", a key no formato JSON Web Key.
• keyData é uma ArrayBuffer ou uma JSONWebKey contendo uma key no formato dado.
• algo é um objeto de dicionário que define o algoritmo que foi utilizado para gerar a key que está sendo importada.
• extractable é um Boolean indicando se a key pode ser extraída de um objeto CryptoKey em um estágio mais tardio.
• usages é um Array que indica o que pode ser feito com a key. Valores possíveis do array são:
  • "encrypt", permitindo que a key seja utilizada para encrypting mensagens.
  • "decrypt", permitindo que a key seja utilizada para decrypting mensagens.
  • "sign", permitindo que a key seja utilizada para signing mensagens.
  • "verify", permitindo que a key seja utilizada para verifying the signature de mensagens.
  • "deriveKey", permitindo que a key seja utilizada como uma key base na derivação de uma nova key.
  • "deriveBits", permitindo que a key seja utilizada como key base na derivação de bits de informação para uso em criptografias primitivas.
  • "wrapKey", permitindo que a key envolva uma key simétrica para uso (transferência, armazenamento) em ambientes não seguros.
  • "unwrapKey", permitindo que a key se desvincule de uma key simétrica para uso (transferência, armazenamento) em ambientes não seguros.

Valor de retorno

• result é uma Promise que retorna a CryptoKey gerada.

Exceções

A promise é rejeitada quando umas das seguintes exceções é encontrada:

• SyntaxError quando keyUsages está vazia mas a key desvinculada é do tipo "secret" ou "private".
• TypeError quando tentando utilizar um formato invalido ou se a keyData não é adequada para este formato.

Especificações

Compatibilidade de Browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Veja também

• Crypto e Crypto.subtle.
• SubtleCrypto, a interface a qual ele pertence.

Dicionário:

"Key" = "Chave"