CERTPRIVATEKEY (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

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

  • Uma 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 um texto não criptografado para os usuários.
  • Uma senha de descriptografia opcional. Uma senha de descriptografia especificada é usada para descriptografar a chave privada do certificado. Caso contrário, a chave mestra de banco de dados é usada.

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

Syntax

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

Arguments

certificate_ID
A certificate_id do certificado. Obtenha esse valor de sys.certificates ou da função CERT_ID (Transact-SQL). cert_id tem um 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 retorno

varbinary

Remarks

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

Permissions

CERTPRIVATEKEY está disponível publicamente.

Examples

Note

Quando você executa CREATE DATABASE sem opções adicionais no Banco de Dados SQL do Azure, o banco de dados é criado no servidor lógico com as configurações padrão. No Banco de Dados SQL do Azure ou SQL Database no Microsoft Fabric, se o banco de dados pretendido já existir, você pode pular as instruções do exemplo CREATE DATABASE e não suportadas USE e se conectar diretamente a esse banco de dados.

USE [master];
GO
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');

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

Conteúdo relacionado

  • Última atualização em