CERTPRIVATEKEY (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Esta função retorna a chave privada de um certificado em formato binário. Esta função utiliza três argumentos.

• Um ID de certificado.
• Uma senha de criptografia, usada para criptografar os bits de chave privada retornados pela função. Essa abordagem não expõe as chaves como texto não criptografado para os usuários.
• Uma palavra-passe de desencriptação opcional. Uma senha de descriptografia especificada é usada para descriptografar a chave privada do certificado. Caso contrário, a chave mestra do banco de dados será usada.

Somente usuários com acesso à chave privada do certificado podem usar essa função. Esta função retorna a chave privada no formato PVK.

Syntax

CERTPRIVATEKEY   
    (  
          cert_ID   
        , ' encryption_password '   
      [ , ' decryption_password ' ]  
    )  

Arguments

certificate_ID
O certificate_id do certificado. Obtenha esse valor de sys.certificates ou da função CERT_ID (Transact-SQL). cert_id tem o tipo de dados int.

encryption_password
A senha usada para criptografar o valor binário retornado.

decryption_password
A senha usada para descriptografar o valor binário retornado.

Tipos de devolução

varbinary

Remarks

Use CERTENCODED e CERTPRIVATEKEY juntos para retornar diferentes partes de um certificado, em formato binário.

Permissions

CERTPRIVATEKEY está disponível publicamente.

Examples

CREATE DATABASE TEST1;  
GO  
USE TEST1  
CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'Use 5tr0ng P^55Words'  
GO  
CREATE CERTIFICATE Shipping04   
WITH SUBJECT = 'Sammamish Shipping Records',   
EXPIRY_DATE = '20401031';  
GO  
SELECT CERTPRIVATEKEY(CERT_ID('Shipping04'), 'jklalkaa/; uia3dd');  

Consulte CERTENCODED (Transact-SQL), Exemplo B, para obter um exemplo mais complexo que usa CERTPRIVATEKEY e CERTENCODED para copiar um certificado para outro banco de dados.

Consulte também

Funções de segurança (Transact-SQL)
CREATE CERTIFICATE (Transact-SQL)Funções de Segurança (Transact-SQL)sys.certificates (Transact-SQL)