CERTPRIVATEKEY (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureAzure 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

Note

Quando executa CREATE DATABASE sem opções adicionais no Base de Dados SQL do Azure, a base de dados é criada no servidor lógico com as definições predefinidas. No Base de Dados SQL do Azure ou SQL Database no Microsoft Fabric, se a base de dados pretendida já existir, pode saltar as instruções do exemplo CREATE DATABASE e não suportadas USE e ligar-se diretamente a essa base 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');

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.

Conteúdo relacionado

  • Última atualização a