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
é umaArrayBuffer
ou umaJSONWebKey
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
é umBoolean
indicando se a key pode ser extraída de um objetoCryptoKey
em um estágio mais tardio.usages
é umArray
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
Exceções
A promise é rejeitada quando umas das seguintes exceções é encontrada:
SyntaxError
quandokeyUsages
está vazia mas a key desvinculada é do tipo"secret"
ou"private"
.TypeError
quando tentando utilizar um formato invalido ou se akeyData
não é adequada para este formato.
Especificações
Especificação | Status | Comentário |
---|---|---|
Web Cryptography API The definition of 'SubtleCrypto.importKey()' in that specification. |
Recomendação | Definição inicial. |
Compatibilidade de Browser
Estamos convertendo nossos dados de compatibilidade para o formato JSON.
Esta tabela de compatibilidade ainda usa o formato antigo,
pois ainda não convertemos os dados que ela contém.
Descubra como você pode ajudar! (en-US)
Características | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Suporte básico | 37 | (Yes) | 34 (34) | Não suportado | ? | Não suportado |
ECDH |
? | ? | 41 (41) | ? | ? | ? |
Características | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Suporte básico | (Yes) | 37 | (Yes) | 34.0 (34) | Não suportado | ? | Não suportado |
ECDH |
? | ? | ? | 41 (41) | ? | ? | ? |
Veja também
Crypto
eCrypto.subtle
.SubtleCrypto
, a interface a qual ele pertence.
Dicionário:
"Key" = "Chave"