Rotazione delle credenziali di Agora

Queste istruzioni spiegano come ruotare i Token di Identità e sostituire le chiavi API gestite su agora.dequecloud.com. Questo include le credenziali di Agora memorizzate in:

• .npmrc e .yarnrc.yml
• Logins Docker
• Maven settings.xml
• nuget.config
• pip.conf
• Configurazione di Bundler
• Proprietà di Gradle
• Segreti CI
• Configurazione nella propria istanza di Artifactory o Nexus che fa da proxy ad Agora

This does non include Axe Account credentials or Axe Account API keys managed at https://axe.deque.com/settings. Those are separate from Agora Identity Tokens.

La rotazione consiste generalmente in:

1. Genera un nuovo Token di Identità.
2. Inseriscilo ovunque elencato sopra, al posto del vecchio token, chiave API o stringa di autenticazione.
3. Revoca il vecchio Token di Identità da Modifica Profilo in Agora.

Riferimento rapido

Il supporto per le chiavi API di Agora è terminato a febbraio 2026, quindi Agora non le accetta più. Sostituisci quelle che hai ancora con un Token di Identità.

Accesso ad Agora

Vai a https://agora.dequecloud.com/. Agora ti invia a auth.deque.com per accedere con il tuo Account Axe, lo stesso che usi per axe DevTools su https://axe.deque.com. Se la tua organizzazione accede all'Account Axe tramite il proprio SSO, Agora utilizza anche quello.

Genera un nuovo Token di Identità

1. Accedi ad Agora.
2. Seleziona il pulsante Benvenuto, il-tuo-indirizzo-email nella barra superiore, quindi seleziona Modifica Profilo. Puoi anche andare direttamente a https://agora.dequecloud.com/ui/admin/artifactory/user_profile.
3. Seleziona Genera un Token di Identità. Opzionalmente aggiungi una descrizione, come "laptop npm" o "GitHub Actions", quindi seleziona Avanti.
4. Copia ora il token. Questa è la tua unica possibilità di vederne il valore.

Ovunque un tool chieda un nome utente e una password, usate l'email del vostro Account Axe come nome utente e il Token di Identità come password.

npm e Yarn

Le tue .npmrc righe per Agora contengono il token stesso. La stringa _auth è una copia codificata della tua email e del token, quindi richiede anch'essa la rigenerazione.

Più facile: incolla la tua email e il nuovo Token di Identità nel tool Configurazione dell'accesso ai pacchetti Agora. Poi sostituisci le righe Agora nel tuo .npmrc con quelle che ti fornisce.

Manuale: genera una nuova stringa di autenticazione:

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

Poi sostituisci il vecchio valore _auth per ogni registro Agora nel tuo .npmrc, di solito 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

Se usi _authToken, impostalo sul nuovo Token di Identità:

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

Yarn 2 e successivi: aggiorna npmAuthIdent (o npmAuthToken) per l'ambito Agora in .yarnrc.yml.

In CI: aggiorna il segreto che la tua pipeline scrive in .npmrc.

Docker

Se tiri immagini da agora.dequecloud.com:1083, come l'immagine Linter di axe DevTools, effettua di nuovo il login. Usa l'email del tuo Account Axe e il tuo nuovo Token di Identità, non una chiave API:

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

Incolla il Token di Identità, premi Invio, quindi premi Ctrl+D (Ctrl+Z poi Invio su Windows).

Nel CI, aggiorna il segreto che il tuo passaggio docker login utilizza.

I file tar immagine che scarichi e docker load funzionano come qualsiasi altro download. Vedi Download con curl, script e CI.

Maven, Gradle, NuGet, PyPI e gemme Ruby

In ogni caso, sostituisci il vecchio Token di Identità o chiave API con il nuovo Token di Identità:

• Maven: in ~/.m2/settings.xml, il <password> del <server> il cui <id> è deque.

• Gradle (axe DevTools Mobile): agora_identity_token nelle tue proprietà Gradle. Se hai ancora artifactory_apikey dalle vecchie istruzioni, cambialo con un Token di Identità.

• NuGet:

  • Con nuget.config, aggiorna ClearTextPassword sotto packageSourceCredentials per la fonte Agora.
  • In Visual Studio, rimuovi la credenziale salvata per agora.dequecloud.com dal Gestore Credenziali di Windows, quindi accedi nuovamente con il nuovo token quando richiesto.
  • Se hai utilizzato una password criptata, sostituisci anche quella.

• PyPI: aggiorna il token nell'URL dell'indice devtools-python in pip.conf, o in PIP_EXTRA_INDEX_URL. Se la tua email contiene @, codificala in URL come %40.

• Gemme Ruby:

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

Account di servizio e gestori di repository

Se la tua istanza di Artifactory o Nexus funge da proxy per Agora, o il tuo CI utilizza un account di servizio Agora dedicato:

1. Ottieni un nuovo Token di Identità per l'account di servizio. Il proprietario dell'account può generarne uno; altrimenti, chiedi a Deque di emetterne uno, come quando è stato configurato l'account.
2. Aggiorna la credenziale memorizzata nel repository remoto o proxy, o nel segreto CI. Vedi Configura il tuo Artifactory o Configura il tuo Nexus.
3. Cancella la cache delle richieste fallite del gestore del repository se ha memorizzato in cache risposte 401 mentre la sua credenziale era obsoleta.

Download con curl, script e CI

Sostituisci il vecchio token o chiave API in ogni script e segreto CI, come AGORA_IDENTITY_TOKEN. Gli script che lo inviano nell'intestazione X-JFrog-Art-Api continuano a funzionare una volta che quel valore è un nuovo Token di 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 funziona anche.

Hai bisogno di aiuto?

Contatta direttamente il tuo rappresentante Deque oppure invia una richiesta di supporto tramite il Centro di Supporto Deque. Includi l'email del tuo account Axe e lo strumento che stai utilizzando.