ALTER ASYMMETRIC KEY (Transact-SQL)ALTER ASYMMETRIC KEY (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Permet de modifier les propriétés d'une clé asymétrique.Changes the properties of an asymmetric key.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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'  

ArgumentsArguments

Asym_Key_NameAsym_Key_Name
Nom sous lequel la clé asymétrique est connue dans la base de données.Is the name by which the asymmetric key is known in the database.

REMOVE PRIVATE KEYREMOVE PRIVATE KEY
Permet de supprimer la clé privée de la clé asymétrique, sans supprimer la clé publique.Removes the private key from the asymmetric key The public key is not removed.

WITH PRIVATE KEYWITH PRIVATE KEY
Modifie la protection de la clé privée.Changes the protection of the private key.

ENCRYPTION BY PASSWORD ='strongPassword'ENCRYPTION BY PASSWORD ='strongPassword'
Spécifie un nouveau mot de passe pour protéger la clé privée.Specifies a new password for protecting the private key. password doit satisfaire aux critères de la stratégie de mot de passe Windows de l’ordinateur qui exécute l’instance de SQL ServerSQL Server.password must meet the Windows password policy requirements of the computer that is running the instance of SQL ServerSQL Server. Si cette option est omise, la clé privée sera chiffrée à l'aide de la clé principale de base de données.If this option is omitted, the private key will be encrypted by the database master key.

DECRYPTION BY PASSWORD ='oldPassword'DECRYPTION BY PASSWORD ='oldPassword'
Spécifie l'ancien mot de passe au moyen duquel la clé privée est actuellement protégée.Specifies the old password, with which the private key is currently protected. Cette option n'est pas requise si la clé privée est chiffrée à l'aide de la clé principale de base de données.Is not required if the private key is encrypted with the database master key.

NotesRemarks

Si aucune clé principale de base de données n'existe, l'option ENCRYPTION BY PASSWORD est requise et l'opération échouera si aucun mot de passe n'est fourni.If there is no database master key the ENCRYPTION BY PASSWORD option is required, and the operation will fail if no password is supplied. Pour plus d’informations sur la création d’une clé principale de base de données, consultez CREATE MASTER KEY (Transact-SQL).For information about how to create a database master key, see CREATE MASTER KEY (Transact-SQL).

Vous pouvez utiliser ALTER ASYMMETRIC KEY pour modifier la protection de la clé privée en spécifiant des options PRIVATE KEY, comme l'illustre le tableau ci-dessous.You can use ALTER ASYMMETRIC KEY to change the protection of the private key by specifying PRIVATE KEY options as shown in the following table.

Changer la protectionChange protection from ENCRYPTION BY PASSWORDENCRYPTION BY PASSWORD DECRYPTION BY PASSWORDDECRYPTION BY PASSWORD
De l'ancien mot de passe au nouveau mot de passeOld password to new password RequisRequired RequisRequired
Du mot de passe à la clé principalePassword to master key OmettreOmit RequisRequired
De la clé principale au mot de passeMaster key to password RequisRequired OmettreOmit

La clé principale de base de données doit être ouverte pour pouvoir être utilisée pour protéger une clé privée.The database master key must be opened before it can be used to protect a private key. Pour plus d’informations, consultez OPEN MASTER KEY (Transact-SQL).For more information, see OPEN MASTER KEY (Transact-SQL).

Pour modifier la propriété d’une clé asymétrique, utilisez ALTER AUTHORIZATION.To change the ownership of an asymmetric key, use ALTER AUTHORIZATION.

AutorisationsPermissions

Requiert l'autorisation CONTROL sur la clé asymétrique si la clé privée doit être supprimée.Requires CONTROL permission on the asymmetric key if the private key is being removed.

ExemplesExamples

A.A. Modification du mot de passe de la clé privéeChanging the password of the private key

Dans l'exemple ci-dessous, le mot de passe utilisé pour protéger la clé privée de la clé asymétrique PacificSales09 est modifié.The following example changes the password used to protect the private key of asymmetric key PacificSales09. Le nouveau mot de passe est <enterStrongPasswordHere>.The new password will be <enterStrongPasswordHere>.

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

B.B. Suppression de la clé privée d'une clé asymétriqueRemoving the private key from an asymmetric key

Dans l'exemple ci-dessous, la clé privée est supprimée de PacificSales19 et seule la clé publique demeure.The following example removes the private key from PacificSales19, leaving only the public key.

ALTER ASYMMETRIC KEY PacificSales19 REMOVE PRIVATE KEY;  
GO  

C.C. Suppression de la protection par mot de passe d'une clé privéeRemoving password protection from a private key

Dans l'exemple ci-dessous, la protection par mot de passe d'une clé privée est supprimée et la clé est protégée au moyen de la clé principale de base de données.The following example removes the password protection from a private key and protects it with the database master key.

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

Voir aussiSee Also

CREATE ASYMMETRIC KEY (Transact-SQL) CREATE ASYMMETRIC KEY (Transact-SQL)
DROP ASYMMETRIC KEY (Transact-SQL) DROP ASYMMETRIC KEY (Transact-SQL)
SQL Server et clés de chiffrement de base de données (moteur de base de données) SQL Server and Database Encryption Keys (Database Engine)
Hiérarchie de chiffrement Encryption Hierarchy
CREATE MASTER KEY (Transact-SQL) CREATE MASTER KEY (Transact-SQL)
OPEN MASTER KEY (Transact-SQL) OPEN MASTER KEY (Transact-SQL)
Gestion de clés extensible (EKM)Extensible Key Management (EKM)