ALTER CREDENTIAL (Transact-SQL)

  • Artículo

Cambia las propiedades de una credencial.

Icono de vínculo a temas 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 va a usar al conectarse fuera del servidor.

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

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.

Para obtener más información acerca de credenciales, vea 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

Referencia

CREATE CREDENTIAL (Transact-SQL)

DROP CREDENTIAL (Transact-SQL)

CREATE LOGIN (Transact-SQL)

sys.credentials (Transact-SQL)

Conceptos

Credenciales (motor de base de datos)