Todos los productos
Search
Centro de documentos

Resource Access Management:Create an AccessKey pair

Última actualización: Sep 12, 2026

Un par de AccessKey es una credencial a largo plazo para acceder mediante programación a las API de Alibaba Cloud. Puede crear un par de AccessKey para un usuario de RAM o para una cuenta de Alibaba Cloud.

¿Qué es un par de AccessKey?

Un par de AccessKey consta de un AccessKey ID y un AccessKey secret, que se usan en conjunto para autenticar las solicitudes programáticas hacia Alibaba Cloud.

  • AccessKey ID: el identificador público y único del par de AccessKey.

  • AccessKey secret: la clave privada que se usa para firmar las solicitudes de API. La firma comprueba la autenticidad e integridad de la solicitud. Debe mantener su AccessKey secret bajo estricta confidencialidad.

Importante

Para reducir el riesgo de filtración, el AccessKey secret se muestra solo una vez al momento de crearlo y no se puede recuperar.

Cómo usar un par de AccessKey

Use un par de AccessKey para llamar a las API de Alibaba Cloud mediante la CLI, los SDK o Terraform.

Alibaba Cloud también ofrece alternativas más seguras basadas en credenciales de seguridad temporales (tokens STS). Para obtener más detalles, consulte Application development scenarios.

Si necesita usar un par de AccessKey, revise la siguiente práctica recomendada: Properly store and use unavoidable AccessKey pairs.

Cómo funciona un par de AccessKey

Resource Access Management (RAM) genera el AccessKey ID y el AccessKey secret de forma algorítmica. Alibaba Cloud los cifra tanto durante el almacenamiento como durante la transmisión.

Cuando una aplicación envía una solicitud, incluye el AccessKey ID y una firma derivada del AccessKey secret. Alibaba Cloud utiliza estos datos para autenticar al remitente y comprobar la integridad de la solicitud. Para obtener más información sobre el mecanismo de firma que utiliza Alibaba Cloud, consulte Request body and signature mechanism for V3.

Tipos de AccessKey

Los pares de AccessKey se dividen en dos tipos según su propietario:

  • Par de AccessKey de la cuenta de Alibaba Cloud (no recomendado)

    Este par de AccessKey pertenece a la cuenta de Alibaba Cloud. De manera predeterminada, tiene permisos completos sobre todos los recursos de la cuenta. Si se ve comprometido, el riesgo de seguridad es extremadamente alto. Se recomienda encarecidamente no crear ni usar un par de AccessKey para su cuenta de Alibaba Cloud.

  • Par de AccessKey de un usuario de RAM (recomendado)

    Este par de AccessKey pertenece a un usuario de RAM, el cual debe crear primero. El par de AccessKey hereda los permisos del usuario de RAM, lo que permite gestionar el acceso con el principio de mínimo privilegio. Como práctica recomendada, asigne un usuario de RAM y un par de AccessKey independientes para cada aplicación. Esto evita otorgar permisos excesivos y reduce el impacto si las credenciales se ven comprometidas.

Requisitos de permisos

Una cuenta de Alibaba Cloud tiene permisos sin restricciones, por lo que debe evitar usarla para crear pares de AccessKey en producción. En su lugar, utilice un usuario de RAM con los permisos adecuados para crear y gestionar pares de AccessKey (excepto los que pertenecen a la cuenta de Alibaba Cloud).

  • Puede asignar la política de sistema AliyunRAMFullAccess (administrador de RAM) a un administrador para permitirle crear y gestionar pares de AccessKey de los usuarios de RAM.

  • También puede habilitar la opción Allow users to manage AccessKey en la configuración de seguridad global de RAM para que los usuarios gestionen sus propios pares de AccessKey. Para obtener más información, consulte Manage security settings for RAM users.

    Nota

    Habilitar esta configuración implica que todos los usuarios de RAM podrán gestionar sus propios pares de AccessKey, lo que incluye crearlos, deshabilitarlos y eliminarlos, a menos que un administrador adjunte una política que deniegue explícitamente estas operaciones.

    No se recomienda habilitar esta configuración en un entorno de producción. Para permitir que un usuario específico gestione su propio par de AccessKey, se recomienda utilizar una política personalizada y establecer el elemento Resource con la identidad del propio usuario. Consulte las siguientes políticas de ejemplo:

    Create AccessKey

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ram:CreateAccessKey",
            "ram:ListAccessKeys"
          ],
          "Resource": "acs:ram:*:ACCOUNT_ID:user/USER_NAME"
        }
      ]
    }

    Manage AccessKey

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ram:CreateAccessKey",
            "ram:ListAccessKeys",
            "ram:UpdateAccessKey",
            "ram:DeleteAccessKey",
            "ram:GetAccessKeyLastUsed",
            "ram:ListAccessKeysInRecycleBin"
          ],
          "Resource": "acs:ram:*:ACCOUNT_ID:user/USER_NAME"
        }
      ]
    }

Crear un AccessKey para un usuario de RAM

Complete los siguientes pasos como administrador de RAM (un usuario con la política AliyunRAMFullAccess). Si no tiene usuarios de RAM en su cuenta, consulte Create a RAM user.

Nota

Los pasos para que un usuario de RAM cree su propio par de AccessKey son los mismos que los descritos en creating an AccessKey pair for an Alibaba Cloud account. Antes de que un usuario de RAM pueda crear su propio par de AccessKey, el propietario de la cuenta de Alibaba Cloud debe habilitar la opción Allow users to manage AccessKey. De lo contrario, el usuario de RAM no verá la opción para crear una clave. Para obtener más información, consulte Manage security settings for RAM users.

Console

  1. Inicie sesión en la consola de RAM. En el panel de navegación izquierdo, elija Identities > Users.

  2. En la lista de usuarios, busque el RAM User y haga clic en su nombre de usuario.

  3. En la pestaña Credential, dentro de la sección AccessKey, haga clic en Create AccessKey.

    Nota

    Cada usuario de RAM puede tener un máximo de dos pares de AccessKey. Uno se destina al uso activo y el segundo a la rotación.

  4. En el cuadro de diálogo que aparece, lea los casos de uso y las recomendaciones. Siga las recomendaciones para elegir una solución de credenciales más adecuada. Si necesita crear un par de AccessKey, seleccione un caso de uso, active la casilla I confirm that it is necessary to create an AccessKey y luego haga clic en Continue. El caso de uso que seleccione no afecta al par de AccessKey creado.

  5. Complete la verificación de seguridad según las indicaciones.

  6. En el cuadro de diálogo Create AccessKey, guarde el AccessKey ID y el AccessKey secret, y luego haga clic en OK.

    (Opcional) Configurar una política de ACL de red para el AccessKey: puede restringir las direcciones IP de origen de las solicitudes de API que utilizan este par de AccessKey. Esto ayuda a mejorar la seguridad, ya que garantiza que el par de AccessKey solo se use desde entornos de red de confianza. Se recomienda hacer clic en Configure network access policy para definir los entornos de red de confianza para este par de AccessKey. Para obtener más información, consulte Configure an AccessKey network ACL policy for a RAM user.

    En las recomendaciones de seguridad, también puede establecer el tiempo máximo de inactividad del par de AccessKey (se recomienda la deshabilitación automática tras 90 días de inactividad). Haga clic en Go to Settings para configurarlo.

    Importante

    Para reducir el riesgo de filtración, el AccessKey secret se muestra solo una vez al momento de crearlo y no se puede recuperar.

API

Llame a la operación CreateAccessKey y especifique el siguiente parámetro:

  • UserPrincipalName: el nombre de inicio de sesión del usuario de RAM, por ejemplo, test@example.onaliyun.com. Puede encontrar el nombre de inicio de sesión en la consola de RAM.

Importante

Para reducir el riesgo de filtración, el AccessKey secret se devuelve únicamente en la respuesta de la operación CreateAccessKey. No se puede recuperar posteriormente.

Crear un AccessKey para una cuenta de Alibaba Cloud (no recomendado)

Aviso

A menos que sea absolutamente necesario, se recomienda encarecidamente no crear ni usar un par de AccessKey para su cuenta de Alibaba Cloud. Antes de continuar, evalúe si puede utilizar el par de AccessKey de un usuario de RAM.

  1. Inicie sesión en la consola de Alibaba Cloud con su cuenta de Alibaba Cloud.

  2. Coloque el cursor sobre su foto de perfil en la esquina superior derecha y haga clic en AccessKey.

  3. En el cuadro de diálogo We do not recommend that you use the AccessKey of your Alibaba Cloud account, lea los riesgos de crear un par de AccessKey para su cuenta de Alibaba Cloud. Si necesita continuar, active la casilla I am aware of the security risks of using a main account AccessKey. y luego haga clic en Continue to use the AccessKey of my Alibaba Cloud account.

  4. En la página AccessKey, haga clic en Create AccessKey.

    Nota

    Una cuenta de Alibaba Cloud puede tener un máximo de dos pares de AccessKey. Uno se destina al uso activo y el segundo a la rotación.

  5. En el cuadro de diálogo Create Main Account AccessKey, revise nuevamente los riesgos y las limitaciones. Si está seguro de que desea crear el par de AccessKey, active la casilla I am aware of the security risks of using a main account AccessKey. y luego haga clic en Continue to use the AccessKey of my Alibaba Cloud account.

  6. En el cuadro de diálogo Create AccessKey, guarde el AccessKey ID y el AccessKey secret. Luego, active la casilla I have saved the AccessKey Secret y haga clic en OK.

    (Recomendado) Configurar una política de ACL de red para el AccessKey: puede restringir las direcciones IP de origen de las solicitudes de API que utilizan este par de AccessKey. Esto ayuda a mejorar la seguridad, ya que garantiza que el par de AccessKey solo se use desde entornos de red de confianza. Se recomienda hacer clic en Configure network access policy para definir los entornos de red de confianza para este par de AccessKey. Para obtener más información, consulte Configure an AccessKey network ACL policy for an Alibaba Cloud account.

    Importante

    Para reducir el riesgo de filtración, el AccessKey secret de una cuenta de Alibaba Cloud se muestra solo al momento de crearlo y no se puede recuperar.

Referencias