Rotierende Agora-Zugangsdaten

Diese Anweisungen erklären, wie Identity Tokens aktualisiert und API-Schlüssel verwaltet bei agora.dequecloud.com ersetzt werden. Dazu gehören Agora-Zugangsdaten, die gespeichert sind in:

• .npmrc und .yarnrc.yml
• Docker-Anmeldungen
• Maven settings.xml
• nuget.config
• pip.conf
• Bundler-Konfiguration
• Gradle-Eigenschaften
• CI-Geheimnisse
• Konfiguration in Ihrer eigenen Artifactory- oder Nexus-Instanz, die zu Agora weiterleitet

Dies umfasst nicht die Anmeldedaten des Axe-Kontos oder die Axe-Konto-API-Schlüssel bei https://axe.deque.com/settings nicht. Diese sind getrennt von den Agora Identity Tokens.

Die Rotation besteht allgemein aus:

1. Neues Identity Token generieren.
2. Setzen Sie es überall ein, wie oben aufgeführt, anstelle des alten Tokens, API-Schlüssels oder Authentifizierungsstrings.
3. Ungültig machen des alten Identity Tokens von Profil bearbeiten in Agora.

Schnellreferenz

Die Unterstützung für Agora-API-Schlüssel endete im Februar 2026, daher werden sie von Agora nicht mehr akzeptiert. Ersetzen Sie alle, die Sie noch haben, durch ein Identity Token.

Anmeldung bei Agora

Gehen Sie zu https://agora.dequecloud.com/. Agora leitet Sie zu auth.deque.com weiter, um sich mit Ihrem Axe-Konto anzumelden, demselben Konto, das Sie auch für axe DevTools bei https://axe.deque.com verwenden. Wenn sich Ihre Organisation über ein eigenes SSO beim Axe-Konto anmeldet, nutzt Agora dies ebenfalls.

Neues Identity Token generieren

1. Bei Agora anmelden.
2. Wählen Sie die Schaltfläche Willkommen, Ihre-E-Mail-Adresse in der oberen Leiste aus und dann Profil bearbeiten. Sie können auch direkt zu https://agora.dequecloud.com/ui/admin/artifactory/user_profile gehen.
3. Wählen Sie Identity Token generieren aus. Fügen Sie optional eine Beschreibung hinzu, wie „laptop npm“ oder „GitHub Actions“, und wählen Sie dann Weiter aus.
4. Kopieren Sie jetzt das Token. Dies ist Ihre einzige Gelegenheit, den Wert zu sehen.

Wann immer ein Tool nach einem Benutzernamen und Passwort fragt, verwenden Sie Ihre Axe-Konto-E-Mail als Benutzernamen und das Identität-Token als Passwort.

npm und Yarn

Ihre .npmrc-Zeilen für Agora enthalten das Token selbst. Die _auth-Zeichenfolge ist eine kodierte Kopie Ihrer E-Mail und des Tokens, daher muss sie ebenfalls erneuert werden.

Am einfachsten: fügen Sie Ihre E-Mail und das neue Identität-Token in das Zugriff auf Agora-Pakete konfigurieren-Tool ein. Ersetzen Sie dann die Agora-Linien in Ihrem .npmrc durch die, die Ihnen das Tool gibt.

Manuell: generieren Sie einen neuen Authentifizierungs-String:

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

Ersetzen Sie dann den alten _auth-Wert für jedes Agora-Register in Ihrem .npmrc, normalerweise devtools-npm oder 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

Wenn Sie _authToken verwenden, setzen Sie es stattdessen auf das neue Identität-Token:

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

Yarn 2 und später: aktualisieren Sie npmAuthIdent (oder npmAuthToken) für den Agora-Bereich in .yarnrc.yml.

In CI: aktualisieren Sie das Geheimnis, das Ihre Pipeline in .npmrc schreibt.

Docker

Wenn Sie Bilder von agora.dequecloud.com:1083 herunterziehen, wie das axe DevTools Linter-Bild, melden Sie sich erneut an. Verwenden Sie Ihre Axe-Konto-E-Mail und Ihr neues Identität-Token, nicht einen API-Schlüssel:

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

Fügen Sie das Identität-Token ein, drücken Sie Enter und dann Strg+D (Strg+Z und dann Enter auf Windows).

In CI aktualisieren Sie das Geheimnis, das Ihr docker login-Schritt verwendet.

Image-Tars, die Sie herunterladen und docker load funktionieren wie jeder andere Download. Siehe Downloads mit Curl, Skripten und CI.

Maven, Gradle, NuGet, PyPI und Ruby Gems

Ersetzen Sie in jedem Fall das alte Identität-Token oder den API-Schlüssel durch das neue Identität-Token:

• Maven: in ~/.m2/settings.xml, der <password> des <server>, dessen <id> deque ist.

• Gradle (axe DevTools Mobile): agora_identity_token in Ihren Gradle-Eigenschaften. Wenn Sie noch artifactory_apikey aus älteren Anleitungen haben, wechseln Sie zu einem Identität-Token.

• NuGet:

  • Mit nuget.config, aktualisieren Sie ClearTextPassword unter packageSourceCredentials für die Agora-Quelle.
  • Entfernen Sie in Visual Studio die gespeicherte Anmeldeinformation für agora.dequecloud.com aus dem Windows-Anmeldeinformations-Manager und melden Sie sich dann erneut mit dem neuen Token an, wenn Sie dazu aufgefordert werden.
  • Wenn Sie ein verschlüsseltes Passwort verwendet haben, ersetzen Sie es ebenfalls.

• PyPI: aktualisieren Sie das Token in der devtools-python-Index-URL in pip.conf oder in PIP_EXTRA_INDEX_URL. Wenn Ihre E-Mail @ enthält, URL-kodieren Sie es als %40.

• Ruby Gems:

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

Dienstkonten und Repositorium-Manager

Wenn Ihre Artifactory- oder Nexus-Instanz Agora proxyt, oder Ihr CI ein dediziertes Agora-Dienstkonto verwendet:

1. Holen Sie sich ein neues Identität-Token für das Dienstkonto. Der Kontoinhaber kann eines erzeugen; andernfalls bitten Sie Deque, eines auszustellen, wie bei der Einrichtung des Kontos.
2. Aktualisieren Sie die Anmeldeinformationen, die im Remote- oder Proxy-Repository oder im CI-Geheimnis gespeichert sind. Siehe Richten Sie Ihr Artifactory ein oder Richten Sie Ihr Nexus ein.
3. Löschen Sie den Cache des Repositorium-Managers für fehlgeschlagene Anfragen, wenn er 401-Antworten zwischengespeichert hat, während seine Anmeldeinformationen veraltet waren.

Downloads mit Curl, Skripten und CI

Ersetzen Sie das alte Token oder den API-Schlüssel in jedem Skript und CI-Geheimnis, wie zum Beispiel AGORA_IDENTITY_TOKEN. Skripte, die es im X-JFrog-Art-Api-Header senden, funktionieren weiterhin, sobald dieser Wert ein neues Identität-Token ist:

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

Authorization: Bearer $AGORA_IDENTITY_TOKEN funktioniert auch.

Brauchen Sie Hilfe?

Wenden Sie sich direkt an Ihren Deque-Vertreter oder senden Sie eine Support-Anfrage über das Deque Help Center. Geben Sie Ihre Axe-Konto-E-Mail und das von Ihnen verwendete Tool an.