ENCRYPTBYASYMKEY (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Essa função criptografa dados com uma chave assimétrica.

Convenções de sintaxe de Transact-SQL

Sintaxe

EncryptByAsymKey ( Asym_Key_ID , { 'plaintext' | @plaintext } )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

asym_key_ID
A ID de uma chave assimétrica no banco de dados. asym_key_ID tem um tipo de dados int.

cleartext
Um cadeia de caracteres de dados que ENCRYPTBYASYMKEY criptografará com a chave assimétrica. texto não criptografado pode ter um

• binary
• char
• nchar
• nvarchar
• varbinary

ou

• varchar

tipo de dados.

@plaintext
Uma variável que contém um valor que ENCRYPTBYASYMKEY criptografará com a chave assimétrica. @plaintext pode ter um

• binary
• char
• nchar
• nvarchar
• varbinary

ou

• varchar

tipo de dados.

Tipos de retorno

varbinary, com um tamanho máximo de 8.000 bytes.

Comentários

Operações de criptografia e descriptografia que usam chaves assimétricas consomem recursos significativos e, portanto, tornam-se caras quando comparadas à descriptografia e criptografia de chave simétrica. Sugerimos que os desenvolvedores evitem operações de criptografia e de descriptografia de chave assimétrica ao trabalharem com grandes conjuntos de dados, por exemplo, conjuntos de dados do usuário armazenados em tabelas de banco de dados. Em vez disso, sugerimos que os desenvolvedores primeiro criptografem dados com uma chave simétrica forte e, em seguida, criptografem a chave simétrica com uma chave assimétrica.

Dependendo do algoritmo, ENCRYPTBYASYMKEY retorna NULL se a entrada excede um certo número de bytes. Os limites específicos:

• uma chave RSA de 512 bits pode criptografar até 53 bytes
• uma chave RSA de 1024 bits pode criptografar até 117 bytes
• uma chave RSA de 2048 bits pode criptografar até 245 bytes

No SQL Server, tanto certificados quanto chaves assimétricas servem como wrappers sobre chaves RSA.

Exemplos

Este exemplo criptografa o texto armazenado em @cleartext com a chave assimétrica JanainaAsymKey02. A instrução insere os dados criptografados na tabela ProtectedData04.

INSERT INTO AdventureWorks2022.Sales.ProtectedData04   
    VALUES( N'Data encrypted by asymmetric key ''JanainaAsymKey02''',  
    EncryptByAsymKey(AsymKey_ID('JanainaAsymKey02'), @cleartext) );  
GO  

Consulte Também

DECRYPTBYASYMKEY (Transact-SQL)
CREATE ASYMMETRIC KEY (Transact-SQL)
Hierarquia de criptografia