Un alias de clave es un nombre legible que puede utilizar en lugar de un ID de clave al invocar operaciones de Key Management Service (KMS). Por ejemplo, alias/my-app-key resulta más sencillo de referenciar y gestionar en distintos entornos que 08ec3bb9-034f-485b-b1cd-3459baa8****.
Un alias es un recurso independiente; las acciones sobre un alias no afectan a la clave asociada. Puede reasignar un alias a una clave diferente o eliminarlo por completo sin afectar la clave.
Reglas y restricciones de los alias
|
Regla |
Detalles |
|
Prefijo obligatorio |
|
|
Longitud del nombre (sin incluir el prefijo) |
De 1 a 255 caracteres |
|
Caracteres permitidos |
Letras, dígitos, guiones bajos ( |
|
Formato reservado |
|
|
Unicidad |
Único dentro de una región bajo la misma cuenta de Alibaba Cloud. El mismo nombre de alias puede existir en diferentes regiones. |
|
Relación entre clave y alias |
Una clave puede tener varios alias. Cada alias se asocia exactamente con una clave. |
|
Modificación de un alias |
Los alias no se pueden modificar. Para modificar el alias de una clave, cree uno nuevo para dicha clave y luego elimine el original. |
|
Eliminación de un alias |
Eliminar un alias no elimina la clave asociada. |
|
Permisos de RAM |
Cuando un usuario de Resource Access Management (RAM) realiza operaciones mediante un alias, necesita permisos sobre la clave, no sobre el alias. |
Antes de eliminar un alias, confirme que ya no esté en uso. Si su aplicación todavía hace referencia al alias, eliminarlo podría provocar fallos en el cifrado de datos.
Creación de un alias
Crear un alias para una clave no afecta a sus alias existentes.
Requisitos previos
Antes de empezar, asegúrese de contar con:
Permisos para crear un alias en la clave destino
Si un usuario de RAM va a crear el alias, cree una directiva personalizada que otorgue kms:CreateAlias tanto sobre la clave como sobre el alias. Para obtener más información, consulte Use RAM to manage access to KMS resources.
La siguiente directiva permite al usuario 123456 crear alias/example para la clave 08ec3bb9-034f-485b-b1cd-3459baa8****:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:CreateAlias"
],
"Resource": [
"acs:kms:cn-hangzhou:123456:key/08ec3bb9-034f-485b-b1cd-3459baa8****",
"acs:kms:cn-hangzhou:123456:alias/example"
]
}
]
}Procedimiento
|
Método |
Pasos |
|
Consola de KMS |
1. Inicie sesión en la consola de KMS. En la barra de navegación superior, seleccione una región. En el panel de navegación izquierdo, elija Resource > Keys. 2. En la pestaña Customer Master Keys o en la pestaña Default Keys, busque la clave y haga clic en Details en la columna Actions. 3. En la pestaña Alias, haga clic en Create Alias e introduzca un nombre de alias. |
|
API |
Invoque la operación CreateAlias. |
|
Alibaba Cloud CLI |
Ejecute el siguiente comando:
|
Actualización de un alias
Actualizar un alias lo reasigna a una clave diferente. La clave original no se ve afectada.
Requisitos previos
Antes de empezar, asegúrese de contar con:
Permisos sobre la clave original, la nueva clave y el alias
Si un usuario de RAM va a actualizar el alias, la directiva personalizada debe otorgar kms:UpdateAlias sobre los tres recursos. Para obtener más información, consulte Use RAM to manage access to KMS resources.
La siguiente directiva permite al usuario 123456 reasignar alias/example desde la clave 08ec3bb9-034f-485b-b1cd-3459baa8**` to key `127d2f84-ee5f-4f4d-9d41-dbc1aca2**:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:UpdateAlias"
],
"Resource": [
"acs:kms:cn-hangzhou:123456:key/08ec3bb9-034f-485b-b1cd-3459baa8****",
"acs:kms:cn-hangzhou:123456:key/127d2f84-ee5f-4f4d-9d41-dbc1aca2****",
"acs:kms:cn-hangzhou:123456:alias/example"
]
}
]
}Procedimiento
|
Método |
Pasos |
|
API |
Invoque la operación UpdateAlias. |
|
Alibaba Cloud CLI |
Ejecute el siguiente comando:
|
Consulta de todos los alias
Liste todos los alias bajo su cuenta de Alibaba Cloud en una región.
Requisitos previos
Antes de empezar, asegúrese de contar con:
Permisos para listar alias
Si un usuario de RAM va a consultar alias, la directiva personalizada debe otorgar kms:ListAliases sobre el recurso de alias. Para obtener más información, consulte Use RAM to manage access to KMS resources.
La siguiente directiva permite al usuario 123456 listar todos los alias en una región:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:ListAliases"
],
"Resource": [
"acs:kms:cn-hangzhou:123456:alias"
]
}
]
}Procedimiento
|
Método |
Pasos |
|
API |
Invoque la operación ListAliases. |
|
Alibaba Cloud CLI |
Ejecute el siguiente comando:
|
Consulta de alias de una clave específica
Liste todos los alias asociados con una clave específica.
Requisitos previos
Antes de empezar, asegúrese de contar con:
Permisos sobre la clave destino
Si un usuario de RAM va a consultar los alias de una clave, la directiva personalizada debe otorgar kms:ListAliasesByKeyId sobre dicha clave. Para obtener más información, consulte Use RAM to manage access to KMS resources.
La siguiente directiva permite al usuario 123456 consultar los alias de la clave 127d2f84-ee5f-4f4d-9d41-dbc1aca2****:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:ListAliasesByKeyId"
],
"Resource": [
"acs:kms:cn-hangzhou:123456:key/127d2f84-ee5f-4f4d-9d41-dbc1aca2****"
]
}
]
}Procedimiento
|
Método |
Pasos |
|
API |
Invoque la operación ListAliasesByKeyId. |
|
Alibaba Cloud CLI |
Ejecute el siguiente comando:
|
Eliminación de un alias
Eliminar un alias no elimina la clave asociada.
Antes de eliminar un alias, confirme que ya no esté en uso. Si su aplicación todavía hace referencia al alias, eliminarlo podría provocar fallos en el cifrado de datos.
Requisitos previos
Antes de empezar, asegúrese de contar con:
Permisos tanto sobre la clave como sobre el alias
Si un usuario de RAM va a eliminar el alias, la directiva personalizada debe otorgar kms:DeleteAlias sobre ambos recursos. Para obtener más información, consulte Use RAM to manage access to KMS resources.
La siguiente directiva permite al usuario 123456 eliminar alias/example de la clave 127d2f84-ee5f-4f4d-9d41-dbc1aca2****:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:DeleteAlias"
],
"Resource": [
"acs:kms:cn-hangzhou:123456:key/127d2f84-ee5f-4f4d-9d41-dbc1aca2****",
"acs:kms:cn-hangzhou:123456:alias/example"
]
}
]
}Procedimiento
|
Método |
Pasos |
|
Consola de KMS |
1. Inicie sesión en la consola de KMS. En la barra de navegación superior, seleccione una región. En el panel de navegación izquierdo, elija Resource > Keys. 2. En la pestaña Customer Master Keys o en la pestaña Default Keys, busque la clave y haga clic en Details en la columna Actions. 3. En la pestaña Alias, busque el alias y haga clic en Delete en la columna Actions. |
|
API |
Invoque la operación DeleteAlias. |
|
Alibaba Cloud CLI |
Ejecute el siguiente comando:
|