Rotação de credenciais do Agora

Estas instruções explicam como girar Tokens de Identidade e substituir as chaves de API gerenciadas em agora.dequecloud.com. Isso inclui credenciais do Agora armazenadas em:

• .npmrc e .yarnrc.yml
• Logins do Docker
• Configuração do Maven settings.xml
• nuget.config
• pip.conf
• Configuração do Bundler
• Propriedades do Gradle
• Segredos de CI
• Configuração na sua própria instância do Artifactory ou Nexus que faz proxy para o Agora

Isso não inclui credenciais da Conta Axe ou chaves de API da Conta Axe gerenciadas em https://axe.deque.com/settings. Estas são separadas dos Tokens de Identidade do Agora.

A rotação geralmente consiste em:

1. Gerar um novo Token de Identidade.
2. Coloque-o em todos os lugares listados acima, substituindo o token antigo, a chave de API ou a string de autenticação.
3. Revogue o antigo Token de Identidade de Editar Perfil no Agora.

Referência rápida

O suporte para chaves de API do Agora terminou em fevereiro de 2026, então o Agora não as aceita mais. Substitua qualquer uma que você ainda tenha por um Token de Identidade.

Fazer login no Agora

Vá para https://agora.dequecloud.com/. O Agora o encaminha para auth.deque.com para entrar com sua Conta Axe, a mesma que você usa para axe DevTools em https://axe.deque.com. Se sua organização se conecta ao Axe Account por meio do próprio SSO, o Agora também o utiliza.

Gerar um novo Token de Identidade

1. Entrar no Agora.
2. Selecione o botão Bem-vindo, seu-endereço-de-e-mail na barra superior, depois selecione Editar Perfil. Você também pode ir direto para https://agora.dequecloud.com/ui/admin/artifactory/user_profile.
3. Selecione Gerar um Token de Identidade. Opcionalmente, adicione uma descrição, como „laptop npm“ ou „GitHub Actions“, e então selecione Próximo.
4. Copie o token agora. Esta é a sua única chance de ver o valor dele.

Sempre que uma ferramenta pedir um nome de usuário e senha, use o e-mail da sua Conta Axe como o nome de usuário e o Token de Identidade como a senha.

npm e Yarn

Suas .npmrc linhas para a Agora contêm o token em si. A string _auth é uma cópia codificada do seu e-mail e token, então também precisa ser regenerada.

Mais fácil: cole seu e-mail e novo Token de Identidade na ferramenta Configurando o Acesso aos pacotes da Agora. Substitua então as linhas da Agora no seu .npmrc pelas que ela lhe fornecer.

Manual: gere uma nova string de autenticação:

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

Depois substitua o antigo valor _auth para cada registro da Agora no seu .npmrc, geralmente 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

Se você usar _authToken, configure-o para o novo Token de Identidade:

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

Yarn 2 e posteriores: atualize npmAuthIdent (ou npmAuthToken) para o escopo da Agora em .yarnrc.yml.

No CI: atualize o segredo que sua pipeline escreve em .npmrc.

Docker

Se você puxar imagens de agora.dequecloud.com:1083, como a imagem do axe DevTools Linter, faça login novamente. Use seu e-mail da Conta Axe e seu novo Token de Identidade, não uma chave de API:

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

Cole o Token de Identidade, pressione Enter e então pressione Ctrl+D (Ctrl+Z e depois Enter no Windows).

No CI, atualize o segredo que seu passo docker login usa.

Arquivos tar de imagens que você baixa e docker load funcionam como qualquer outro download. Veja Downloads com curl, scripts e CI.

Maven, Gradle, NuGet, PyPI e Ruby gems

Em cada caso, substitua o antigo Token de Identidade ou chave de API pelo novo Token de Identidade:

• Maven: em ~/.m2/settings.xml, o <password> do <server> cujo <id> é deque.

• Gradle (axe DevTools Mobile): agora_identity_token em suas propriedades do Gradle. Se você ainda tiver artifactory_apikey de instruções antigas, mude para um Token de Identidade.

• NuGet:

  • Com nuget.config, atualize ClearTextPassword em packageSourceCredentials para a fonte Agora.
  • No Visual Studio, remova a credencial salva para agora.dequecloud.com do Gerenciador de Credenciais do Windows e faça login novamente com o novo token quando solicitado.
  • Se você usou uma senha criptografada, a substitua também.

• PyPI: atualize o token na URL do índice devtools-python em pip.conf, ou em PIP_EXTRA_INDEX_URL. Se seu e-mail contiver @, codifique-o na URL como %40.

• Ruby gems:

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

Contas de serviço e gerenciadores de repositório

Se a sua instância Artifactory ou Nexus atuar como proxy da Agora, ou seu CI usar uma conta de serviço dedicada da Agora:

1. Obtenha um novo Token de Identidade para a conta de serviço. O proprietário da conta pode gerar um; caso contrário, peça à Deque para emitir um, como quando a conta foi configurada.
2. Atualize a credencial armazenada no repositório remoto ou proxy, ou no segredo do CI. Veja Configure seu Artifactory ou Configure seu Nexus.
3. Limpe o cache de solicitações falhas do gerenciador de repositório se ele armazenou respostas 401 enquanto sua credencial estava desatualizada.

Downloads com curl, scripts e CI

Substitua o token antigo ou chave de API em todos os scripts e segredos do CI, como AGORA_IDENTITY_TOKEN. Scripts que o enviam no cabeçalho X-JFrog-Art-Api continuam funcionando uma vez que esse valor seja um novo Token de Identidade:

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

Authorization: Bearer $AGORA_IDENTITY_TOKEN também funciona.

Precisa de ajuda?

Entre em contato diretamente com seu representante Deque, ou envie uma solicitação de suporte através da Central de Ajuda Deque. Inclua o seu e-mail da Conta Axe e a ferramenta que está usando.