ALTER CREDENTIAL (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Managed Instance

Cambia las propiedades de una credencial.

Importante

Información "debe hacer" como procedimiento recomendado; "tiene que hacer" para completar la tarea Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

credential_name
Especifica el nombre de la credencial que se va a modificar.

IDENTITY ='identity_name'
Especifica el nombre de la cuenta que se utilizará para conectarse fuera del servidor.

SECRET ='secret'
Especifica el secreto necesario para la autenticación de salida. secret es opcional.

Importante

Azure SQL Database solo admite las identidades de Azure Key Vault y de Firma de acceso compartido. No se admiten las identidades de usuario de Windows.

Comentarios

Cuando se cambia una credencial, se restablecen los valores de identity_name y secret. Si no se especifica el argumento opcional SECRET, el valor del secreto almacenado se establecerá en NULL.

El secreto está cifrado mediante la clave maestra de servicio. Si se vuelve a generar la clave maestra de servicio, el secreto se vuelve a cifrar utilizando la nueva clave maestra de servicio.

Encontrará más información sobre las credenciales en la vista de catálogo sys.credentials.

Permisos

Requiere el permiso ALTER ANY CREDENTIAL. Si la credencial es una credencial del sistema, requiere el permiso CONTROL SERVER.

Ejemplos

A. Cambiar la contraseña de una credencial

En el siguiente ejemplo se cambia el secreto almacenado en una credencial denominada Saddles. La credencial contiene el inicio de sesión de Windows RettigB y su contraseña. La nueva contraseña se agrega a la credencial mediante la cláusula SECRET.

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

B. Quitar la contraseña de una credencial

En el ejemplo siguiente se quita la contraseña de una credencial denominada Frames. La credencial contiene el inicio de sesión de Windows Aboulrus8 y una contraseña. Después de ejecutar la instrucción, la credencial tendrá una contraseña NULL porque no se especifica la opción SECRET.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO

Vea también

Credenciales (motor de base de datos)
CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)