Partilhar via

  • Artigo

ALTER ASYMMETRIC KEY (Transact-SQL)

Altera as propriedades de uma chave assimétrica.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

ALTER ASYMMETRIC KEY Asym_Key_Name <alter_option>

<alter_option> ::=
    <password_change_option> 
    | 
    REMOVE PRIVATE KEY
<password_change_option> ::=
    WITH PRIVATE KEY ( <password_option> [ , <password_option> ] )
<password_option> ::=
    ENCRYPTION BY PASSWORD = 'strongPassword'
    |
    DECRYPTION BY PASSWORD = 'oldPassword'

Argumentos

  • Asym_Key_Name
    É o nome pelo qual a chave assimétrica é conhecida no banco de dados.

  • REMOVE PRIVATE KEY
    Remove a chave particular da chave assimétrica. A chave pública não é removida.

  • WITH PRIVATE KEY
    Altera a proteção da chave particular.

  • ENCRYPTION BY PASSWORD ='stongPassword'
    Especifica uma nova senha para proteger a chave particular. A password deve atender aos requisitos da diretiva de senha do Windows do computador que está executando a instância do SQL Server. Se esta opção for omitida, a chave particular será criptografada pela chave mestra do banco de dados.

  • DECRYPTION BY PASSWORD ='oldPassword'
    Especifica a senha antiga com a qual a chave particular está protegida atualmente. Não será necessária se a chave particular for criptografada com a chave mestra do banco de dados.

Comentários

Se não houver nenhuma chave mestra do banco de dados a opção ENCRYPTION BY PASSWORD será necessária e a operação falhará se nenhuma senha for fornecida. Para obter mais informações sobre como criar uma chave mestra do banco de dados, consulte CREATE MASTER KEY (Transact-SQL).

É possível usar ALTER ASYMMETRIC KEY para alterar a proteção da chave particular especificando as opções PRIVATE KEY conforme mostrado na tabela a seguir.

Alterar a proteção de

ENCRYPTION BY PASSWORD

DECRYPTION BY PASSWORD

Senha antiga para senha nova

Necessário

Necessário

Senha para chave mestra

Omitir

Necessário

Chave mestra para senha

Necessário

Omitir

A chave mestra do banco de dados deve ser aberta antes de poder ser usada para proteger uma chave particular. Para obter mais informações, consulte OPEN MASTER KEY (Transact-SQL).

Para alterar a propriedade de uma chave assimétrica, use ALTER AUTHORIZATION.

Permissões

Requerer a permissão CONTROL na chave assimétrica quando a chave particular é removida.

Exemplos

A. Alterando a senha da chave particular

O exemplo a seguir altera a senha usada para proteger a chave particular da chave assimétrica PacificSales09. A senha nova será <enterStrongPasswordHere>.

ALTER ASYMMETRIC KEY PacificSales09 
    WITH PRIVATE KEY (
    DECRYPTION BY PASSWORD = '<oldPassword>',
    ENCRYPTION BY PASSWORD = '<enterStrongPasswordHere>');
GO

B. Removendo a chave particular de uma chave assimétrica

O exemplo a seguir remove a chave particular de PacificSales19, deixando apenas a chave pública.

ALTER ASYMMETRIC KEY PacificSales19 REMOVE PRIVATE KEY;
GO

C. Removendo a proteção de senha de uma chave particular

O exemplo a seguir remove a proteção de senha de uma chave particular e a protege com a chave mestra do banco de dados.

OPEN MASTER KEY;
ALTER ASYMMETRIC KEY PacificSales09 WITH PRIVATE KEY (
    DECRYPTION BY PASSWORD = '<enterStrongPasswordHere>' );
GO