Het draaien van Agora-referenties

Deze instructies leggen uit hoe u Identiteitstokens kunt draaien en API-sleutels kunt vervangen die worden beheerd op agora.dequecloud.com. Dit omvat Agora-referenties die zijn opgeslagen in:

• .npmrc en .yarnrc.yml
• Docker-logins
• Maven settings.xml
• nuget.config
• pip.conf
• Bundler-configuratie
• Gradle-eigenschappen
• CI-geheimen
• Configuratie in uw eigen Artifactory- of Nexus-instantie die naar Agora proxy’s

Dit omvat niet Axe Account-referenties of Axe Account API-sleutels die worden beheerd op https://axe.deque.com/settings niet. Deze zijn gescheiden van Agora Identiteitstokens.

Rotatie bestaat over het algemeen uit:

1. Genereer een nieuw Identiteitstoken.
2. Plaats het overal bovenstaand vermeld, in plaats van de oude token, API-sleutel of authenticatiestring.
3. Herroep het oude Identiteitstoken van Profiel bewerken in Agora.

Snelle referentie

Ondersteuning voor Agora API-sleutels eindigde in februari 2026, dus Agora accepteert ze niet langer. Vervang de API-sleutels die u nog heeft door een Identiteitstoken.

Inloggen bij Agora

Ga naar https://agora.dequecloud.com/. Agora stuurt u naar auth.deque.com om in te loggen met uw Axe Account, hetzelfde dat u gebruikt voor axe DevTools op https://axe.deque.com. Als uw organisatie zich via haar eigen SSO aanmeldt voor Axe Account, gebruikt Agora dat ook.

Genereer een nieuw Identiteitstoken

1. Log in bij Agora.
2. Selecteer de knop Welkom, uw-e-mailadres in de bovenste balk, selecteer daarna Profiel bewerken. U kunt ook rechtstreeks naar https://agora.dequecloud.com/ui/admin/artifactory/user_profile gaan.
3. Selecteer Genereer een Identiteitstoken. Voeg optioneel een beschrijving toe, zoals „laptop npm” of „GitHub Actions”, en selecteer vervolgens Volgende.
4. Kopieer nu de token. Dit is je enige kans om de waarde te zien.

Waar een tool om een gebruikersnaam en wachtwoord vraagt, gebruik je je Axe Account-e-mailadres als gebruikersnaam en de Identiteittoken als wachtwoord.

npm en Yarn

Je .npmrc regels voor Agora bevatten de token zelf. De _auth string is een gecodeerde kopie van je e-mailadres en token, dus deze moet ook opnieuw gegenereerd worden.

Eenvoudigst: plak je e-mail en nieuwe Identiteittoken in de Toegang tot Agora-pakketten configureren tool. Vervang vervolgens de Agoraregels in je .npmrc met de regels die het je geeft.

Met de hand: genereer een nieuwe auth-string:

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

Vervang vervolgens de oude _auth waarde voor elk Agora-register in je .npmrc, meestal devtools-npm of 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

Als je _authToken gebruikt, stel het dan in op de nieuwe Identiteittoken:

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

Yarn 2 en later: update npmAuthIdent (of npmAuthToken) voor de Agora-scope in .yarnrc.yml.

In CI: update het geheim dat je pipeline naar .npmrc schrijft.

Docker

Als je afbeeldingen downloadt van agora.dequecloud.com:1083, zoals de axe DevTools Linter-afbeelding, log dan opnieuw in. Gebruik je Axe Account-e-mailadres en je nieuwe Identiteittoken, niet een API-sleutel:

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

Plak de Identiteittoken, druk op Enter, druk dan op Ctrl+D (Ctrl+Z en vervolgens Enter op Windows).

In CI, update het geheim dat je docker login stap gebruikt.

Afbeelding-tars die je downloadt en docker load werken net zoals elke andere download. Zie Downloads met curl, scripts en CI.

Maven, Gradle, NuGet, PyPI en Ruby gems

Vervang in elk geval de oude Identiteittoken of API-sleutel door de nieuwe Identiteittoken:

• Maven: in ~/.m2/settings.xml, de <password> van de <server> waarvan <id> is deque.

• Gradle (axe DevTools Mobile): agora_identity_token in je Gradle-eigenschappen. Als je nog artifactory_apikey hebt van oudere instructies, schakel dan over naar een Identiteittoken.

• NuGet:

  • Met nuget.config, update ClearTextPassword onder packageSourceCredentials voor de Agora-bron.
  • Verwijder in Visual Studio de opgeslagen referenties voor agora.dequecloud.com uit de Windows Credential Manager, en meld je dan opnieuw aan met de nieuwe token wanneer hierom wordt gevraagd.
  • Als je een versleuteld wachtwoord gebruikte, vervang het dan ook.

• PyPI: update de token in de devtools-python index-URL in pip.conf, of in PIP_EXTRA_INDEX_URL. Als je e-mail @ bevat, codeer deze dan als %40.

• Ruby gems:

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

Serviceaccounts en repositorymanagers

Als je Artifactory- of Nexus-omgeving Agora proxyt, of als je CI een toegewijd Agora-serviceaccount gebruikt:

1. Verkrijg een nieuwe Identiteittoken voor het serviceaccount. De eigenaar van het account kan er een genereren; vraag anders Deque om er een uit te geven, net als toen het account werd ingesteld.
2. Update de referentie die in de externe of proxy-referentie is opgeslagen, of in het CI-geheim. Zie Installeer je Artifactory of Installeer je Nexus.
3. Wis de cache van mislukte aanvragen van de repositorymanager als deze 401-reacties heeft opgeslagen terwijl de referentie verouderd was.

Downloads met curl, scripts en CI

Vervang de oude token of API-sleutel in elk script en CI-geheim, zoals AGORA_IDENTITY_TOKEN. Scripts die deze in de X-JFrog-Art-Api header versturen, blijven werken zodra die waarde een nieuwe Identiteittoken is:

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

Authorization: Bearer $AGORA_IDENTITY_TOKEN werkt ook.

Hulp nodig?

Neem direct contact op met uw Deque-vertegenwoordiger, of dien een ondersteuningsverzoek in via de Deque Helpcentrum. Voeg uw Axe-account e-mailadres en de tool die u gebruikt toe.