ALTER ASYMMETRIC KEY (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.

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

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

ALTER ASYMMETRIC KEY PacificSales19 REMOVE PRIVATE KEY;
GO

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

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

Consulte também

Referência

Conceitos