Rotation des identifiants Agora

Ces instructions expliquent comment faire tourner les jetons d'identité et remplacer les clés API gérées sur agora.dequecloud.com. Cela inclut les identifiants Agora stockés dans :

• .npmrc et .yarnrc.yml
• Connexions Docker
• Maven settings.xml
• nuget.config
• pip.conf
• Configuration de Bundler
• Propriétés Gradle
• Secrets CI
• Configuration dans votre propre instance Artifactory ou Nexus qui fait proxy vers Agora

Cela n'inclut pas pas les identifiants Axe Account ou les clés API Axe Account gérées sur https://axe.deque.com/settings. Ceux-ci sont distincts des jetons d'identité Agora.

La rotation consiste généralement en :

1. Générer un nouveau jeton d'identité.
2. Mettez-le partout où c'est listé ci-dessus, à la place de l'ancien jeton, clé API ou chaîne d'authentification.
3. Révoquez l'ancien jeton d'identité de Modifier le profil dans Agora.

Référence rapide

Le support pour les clés API Agora a pris fin en février 2026, Agora ne les accepte donc plus. Remplacez celles que vous avez encore par un jeton d'identité.

Se connecter à Agora

Allez à https://agora.dequecloud.com/. Agora vous envoie à auth.deque.com pour vous connecter avec votre compte Axe, le même que vous utilisez pour axe DevTools sur https://axe.deque.com. Si votre organisation se connecte à Axe Account via son propre SSO, Agora l'utilise aussi.

Générer un nouveau jeton d'identité

1. Se connecter à Agora.
2. Sélectionnez le bouton Bienvenue, votre-adresse-e-mail dans la barre supérieure, puis sélectionnez Modifier le profil. Vous pouvez également aller directement à https://agora.dequecloud.com/ui/admin/artifactory/user_profile.
3. Sélectionnez Générer un jeton d'identité. Ajoutez éventuellement une description, comme « laptop npm » ou « GitHub Actions », puis sélectionnez Suivant.
4. Copiez le jeton maintenant. C'est votre seule chance de voir sa valeur.

Partout où un outil demande un nom d'utilisateur et un mot de passe, utilisez votre email de compte Axe comme nom d'utilisateur et le jeton d'identité comme mot de passe.

npm et Yarn

Vos lignes .npmrc pour Agora contiennent le jeton lui-même. La chaîne _auth est une copie encodée de votre email et jeton, il faut donc la régénérer aussi.

Le plus facile : collez votre email et le nouveau jeton d'identité dans l'outil Configurer l'accès aux paquets Agora. Ensuite, remplacez les lignes Agora dans votre .npmrc par celles qu'il vous fournit.

À la main : générez une nouvelle chaîne d'authentification :

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

Ensuite, remplacez l'ancienne valeur _auth pour chaque registre Agora dans votre .npmrc, généralement devtools-npm ou 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 vous utilisez _authToken, remplacez-le par le nouveau jeton d'identité au lieu de cela :

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

Yarn 2 et plus : mettez à jour npmAuthIdent (ou npmAuthToken) pour le scope Agora dans .yarnrc.yml.

Dans CI : mettez à jour le secret que votre pipeline écrit dans .npmrc.

Docker

Si vous tirez des images de agora.dequecloud.com:1083, comme l'image axe DevTools Linter, reconnectez-vous. Utilisez votre email de compte Axe et votre nouveau jeton d'identité, pas une clé API :

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

Collez le jeton d'identité, appuyez sur Entrée, puis appuyez sur Ctrl+D (Ctrl+Z puis Entrée sur Windows).

Dans CI, mettez à jour le secret que votre étape docker login utilise.

Les fichiers tar d'images que vous téléchargez et docker load fonctionnent comme n'importe quel autre téléchargement. Voir Téléchargements avec curl, scripts, et CI.

Maven, Gradle, NuGet, PyPI, et Ruby gems

Dans chaque cas, remplacez l'ancien jeton d'identité ou la clé API par le nouveau jeton d'identité :

• Maven : dans ~/.m2/settings.xml, le <password> de l'<server> dont <id> est deque.

• Gradle (axe DevTools Mobile) : agora_identity_token dans vos propriétés Gradle. Si vous avez encore artifactory_apikey des instructions plus anciennes, remplacez-le par un jeton d'identité.

• NuGet :

  • Avec nuget.config, mettez à jour ClearTextPassword sous packageSourceCredentials pour la source Agora.
  • Dans Visual Studio, supprimez l'identifiant enregistré pour agora.dequecloud.com du gestionnaire d'identifiants Windows, puis reconnectez-vous avec le nouveau jeton lorsque vous y êtes invité.
  • Si vous avez utilisé un mot de passe chiffré, remplacez-le aussi.

• PyPI : mettez à jour le jeton dans l'URL d'index devtools-python dans pip.conf, ou dans PIP_EXTRA_INDEX_URL. Si votre email contient @, encodez-le en URL sous forme de %40.

• Ruby gems :

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

Comptes de service et gestionnaires de dépôts

Si votre instance Artifactory ou Nexus proxy Agora, ou si votre CI utilise un compte de service Agora dédié :

1. Procurez-vous un nouveau jeton d'identité pour le compte de service. Le propriétaire du compte peut en générer un ; sinon, demandez à Deque d'en émettre un, comme lors de la mise en place du compte.
2. Mettez à jour l'identifiant stocké dans le dépôt distant ou proxy, ou dans le secret CI. Voir Configurez votre Artifactory ou Configurez votre Nexus.
3. Effacez le cache des demandes échouées du gestionnaire de dépôts s'il a mis en cache des réponses 401 pendant que son identifiant était obsolète.

Téléchargements avec curl, scripts, et CI

Remplacez l'ancien jeton ou la clé API dans chaque script et secret CI, tel que AGORA_IDENTITY_TOKEN. Les scripts qui l'envoient dans l'en-tête X-JFrog-Art-Api continuent de fonctionner une fois que cette valeur est un nouveau jeton d'identité :

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

Authorization: Bearer $AGORA_IDENTITY_TOKEN fonctionne aussi.

Besoin d'aide ?

Contactez directement votre représentant Deque, ou soumettez une demande d'assistance via le Centre d'aide Deque. Incluez votre adresse email de compte Axe et l'outil que vous utilisez.