Rotación de credenciales de Agora

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Reemplazo de tokens de identidad y claves API usadas para acceder al repositorio de artefactos de Agora de Deque

Not for use with personal data

Estas instrucciones explican cómo rotar los tokens de identidad y reemplazar las claves API gestionadas en agora.dequecloud.com. Esto incluye credenciales de Agora almacenadas en:

  • .npmrc y .yarnrc.yml
  • Inicios de sesión de Docker
  • Maven settings.xml
  • nuget.config
  • pip.conf
  • Configuración de Bundler
  • Propiedades de Gradle
  • Secretos de CI
  • Configuración en su propia instancia de Artifactory o Nexus que se conecta a Agora

Esto no incluye las credenciales de la Cuenta Axe ni las claves API de la Cuenta Axe gestionadas en https://axe.deque.com/settings. Estas son distintas de los tokens de identidad de Agora.

La rotación generalmente consiste en:

  1. Generar un nuevo Token de Identidad.
  2. Póngalo en todos los lugares mencionados anteriormente, en lugar del token, clave API o cadena de autenticación anterior.
  3. Revoque el antiguo Token de Identidad desde Editar perfil en Agora.

Referencia rápida

El soporte para las claves API de Agora terminó en febrero de 2026, por lo que Agora ya no las acepta. Reemplace cualquiera que todavía tenga por un Token de Identidad.

Cómo usa Agora Qué hacer
Iniciar sesión en el sitio web de Agora Inicie sesión con su Cuenta Axe. Vea Iniciar sesión en Agora.
Token de Identidad Genere uno nuevo.
Clave API de Agora Las claves API ya no son compatibles. Generar un Token de Identidad y utilícelo en lugar de la clave API.
npm o Yarn (_auth o _authToken en .npmrc) Regenerar la línea de su nuevo Token de Identidad.
docker login con su nuevo Token de Identidad a agora.dequecloud.com:1083 Iniciar sesión de nuevo con su nuevo Token de Identidad.
Maven, Gradle, NuGet, pip, o Bundler Reemplace la contraseña guardada con su nuevo Token de Identidad.
Cuenta de servicio utilizada por Artifactory, Nexus o CI Obtenga un nuevo token y actualice la copia almacenada.

Iniciar sesión en Agora

Vaya a https://agora.dequecloud.com/. Agora lo redirige a auth.deque.com para iniciar sesión con su Cuenta Axe, la misma que utiliza para axe DevTools en https://axe.deque.com. Si su organización inicia sesión en la Cuenta Axe a través de su propio SSO, Agora también utiliza eso.

Generar un nuevo Token de Identidad

  1. Iniciar sesión en Agora.
  2. Seleccione el botón Bienvenido, tu-dirección-de-correo en la barra superior, luego seleccione Editar perfil. También puede ir directamente a https://agora.dequecloud.com/ui/admin/artifactory/user_profile.
  3. Seleccione Generar un Token de Identidad. Opcionalmente, agregue una descripción, como „portátil npm“ o „GitHub Actions“, y luego seleccione Siguiente.
  4. Copie el token ahora. Esta es su única oportunidad de ver su valor.
important

Los Tokens de Identidad caducan después de un año. Programe un recordatorio para reemplazarlos antes de que eso ocurra.

Dondequiera que una herramienta solicite un nombre de usuario y una contraseña, use su correo electrónico de Cuenta Axe como nombre de usuario y el Token de Identidad como contraseña.

tip

Cree un token separado para cada máquina o línea de producción. Entonces, si uno se expone, puede revocarlo desde Editar perfil sin afectar a los demás.

npm y Yarn

Sus .npmrc líneas para Agora contienen el token en sí. La cadena _auth es una copia codificada de su correo electrónico y token, por lo que también necesita regenerarse.

Más fácil: pegue su correo electrónico y nuevo Token de Identidad en la herramienta Configurar el acceso a los paquetes de Agora. Luego reemplace las líneas de Agora en su .npmrc con las que le proporciona.

A mano: genere una nueva cadena de autenticación:

curl -u "your-email:your-identity-token" "https://agora.dequecloud.com/artifactory/api/npm/auth"

Luego reemplace el viejo valor de _auth para cada registro de Agora en su .npmrc, normalmente devtools-npm o dequelabs:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<new auth string>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Si usa _authToken, configúrelo para el nuevo Token de Identidad en su lugar:

//agora.dequecloud.com/artifactory/api/npm/dequelabs/:_authToken=<new identity token>

Yarn 2 y posteriores: actualice npmAuthIdent (o npmAuthToken) para el ámbito de Agora en .yarnrc.yml.

En CI: actualice el secreto que su pipeline escribe en .npmrc.

Docker

Si descarga imágenes desde agora.dequecloud.com:1083, como la imagen de linter de axe DevTools, inicie sesión de nuevo. Use su correo electrónico de Cuenta Axe y su nuevo Token de Identidad, no una clave API:

docker logout agora.dequecloud.com:1083
docker login agora.dequecloud.com:1083 -u <your-email> --password-stdin

Pegue el Token de Identidad, presione Enter, luego presione Ctrl+D (Ctrl+Z y luego Enter en Windows).

En CI, actualice el secreto que usa su paso docker login.

Los archivos tar de imágenes que descarga y docker load funcionan como cualquier otra descarga. Vea Descargas con curl, scripts y CI.

Maven, Gradle, NuGet, PyPI y Ruby gems

En cada caso, reemplace el viejo Token de Identidad o clave API con el nuevo Token de Identidad:

  • Maven: en ~/.m2/settings.xml, el <password> del <server> cuyo <id> es deque.

  • Gradle (axe DevTools Mobile): agora_identity_token en sus propiedades de Gradle. Si aún tiene artifactory_apikey de instrucciones anteriores, cámbielo por un Token de Identidad.

  • NuGet:

    • Con nuget.config, actualice ClearTextPassword bajo packageSourceCredentials para la fuente Agora.
    • En Visual Studio, quite la credencial guardada para agora.dequecloud.com del Administrador de Credenciales de Windows, luego inicie sesión de nuevo con el nuevo token cuando se le solicite.
    • Si utilizó una contraseña encriptada, sustitúyala también.
  • PyPI: actualice el token en la URL del índice devtools-python en pip.conf, o en PIP_EXTRA_INDEX_URL. Si su correo electrónico contiene @, codifíquelo como URL %40.

  • Ruby gems:

    bundle config agora.dequecloud.com <your-email>:<new identity token>

Cuentas de servicio y gestores de repositorios

Si su instancia de Artifactory o Nexus hace proxy de Agora, o su CI utiliza una cuenta de servicio dedicada a Agora:

  1. Obtenga un nuevo Token de Identidad para la cuenta de servicio. El propietario de la cuenta puede generar uno; de lo contrario, pida a Deque que le emita uno, como cuando se configuró la cuenta.
  2. Actualice la credencial almacenada en el repositorio remoto o proxy, o en el secreto de CI. Vea Configurar su Artifactory o Configurar su Nexus.
  3. Limpie la caché de solicitudes fallidas del gestor de repositorios si almacenó en caché respuestas 401 mientras su credencial estaba desactualizada.

Descargas con curl, scripts y CI

Reemplace el antiguo token o clave API en cada script y secreto de CI, como AGORA_IDENTITY_TOKEN. Los scripts que lo envían en el encabezado X-JFrog-Art-Api seguirán funcionando una vez que ese valor sea un nuevo Token de Identidad:

curl -H "X-JFrog-Art-Api: $AGORA_IDENTITY_TOKEN" -O \
  "https://agora.dequecloud.com/artifactory/<repo>/<path-to-file>"

Authorization: Bearer $AGORA_IDENTITY_TOKEN también funciona.

warning

Si un script o secreto de CI todavía contiene un Clave API (comienza con AKCp), Agora lo rechaza en cualquier encabezado. Reemplácelo con un Token de Identidad.

¿Necesita ayuda?

Póngase en contacto directamente con su representante de Deque o envíe una solicitud de soporte a través del Centro de Ayuda de Deque. Incluya su correo electrónico de la cuenta Axe y la herramienta que está utilizando.

caution

Nunca nos envíe su token de identidad o contraseña. Deque nunca le pedirá que envíe contraseñas o tokens por correo electrónico, así que tenga cuidado con cualquier mensaje inesperado que afirme ser de Deque y lo solicite.