ALTER CREDENTIAL (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Managed Instance

Modifie les propriétés d'une information d'identification.

Important

Les bonnes pratiques sont des pratiques recommandées. D’autres sont obligatoires pour effectuer la tâche Conventions de la syntaxe Transact-SQL

Syntaxe

ALTER CREDENTIAL credential_name WITH IDENTITY = 'identity_name'  
    [ , SECRET = 'secret' ]

Arguments

credential_name
Spécifie le nom d'une information d'identification à modifier.

IDENTITY ='identity_name'
Spécifie le nom du compte à utiliser lors d'une connexion en dehors du serveur.

SECRET ='secret'
Spécifie le secret requis pour l'authentification sortante. secret est facultatif.

Important

Azure SQL Database ne prend en charge que les identités de type signature d’accès partagé et Azure Key Vault. Les identités d’utilisateur Windows ne sont pas prises en charge.

Notes

Quand des informations d’identification sont modifiées, les valeurs d’identity_name et de secret sont réinitialisées. Si l'argument facultatif SECRET n'est pas spécifié, sa valeur stockée est NULL.

Le secret est chiffré au moyen de la clé principale du service. Si cette clé est regénérée, le secret est à nouveau chiffré à l'aide de la nouvelle clé principale du service.

Des informations sur les informations d’identification sont consultables dans la vue de catalogue sys.credentials.

Autorisations

Requiert l'autorisation ALTER ANY CREDENTIAL. Si l'information d'identification est une information d'identification système, l'autorisation CONTROL SERVER est requise.

Exemples

R. Modification du mot de passe d'une information d'identification

Le code exemple suivant modifie le secret stocké dans l'information d'identification nommée Saddles. L'information d'identification contient la connexion Windows RettigB et son mot de passe. Le nouveau mot de passe est ajouté à l'information d'identification à l'aide de la clause SECRET.

ALTER CREDENTIAL Saddles WITH IDENTITY = 'RettigB',   
    SECRET = 'sdrlk8$40-dksli87nNN8';  
GO

B. Suppression du mot de passe d'une information d'identification

Le code exemple suivant supprime le mot de passe de l'information d'identification nommée Frames. L'information d'identification contient la connexion Windows Aboulrus8 et un mot de passe. Après l'exécution de l'instruction, le mot de passe de l'information d'identification a la valeur NULL car l'option SECRET n'est pas spécifiée.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO

Voir aussi

Informations d'identification (moteur de base de données)
CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)

Partager via