Agora資格情報のローテーション

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

DequeのAgoraアーティファクトリポジトリへのアクセスに使用されるIdentityトークンとAPIキーの交換

Not for use with personal data

これらの手順では、agora.dequecloud.comで管理されるIdentityトークンを回転させ、APIキーを交換する方法を説明します。これには、次の場所に保存されているAgora資格情報が含まれます:

  • .npmrcと.yarnrc.yml
  • Dockerログイン
  • Maven settings.xml
  • nuget.config
  • pip.conf
  • Bundlerコンフィグ
  • Gradleプロパティ
  • CIシークレット
  • Agoraへプロキシする独自のArtifactoryまたはNexusインスタンスでの構成

これは、Axeアカウントの資格情報やhttps://axe.deque.com/settingsで管理されているAxeアカウントAPIキーを含まれていない含みません。それらはAgoraのIdentityトークンとは別です。

ローテーションは通常、次の手順で構成されます:

  1. 新しいIdentityトークンを生成する。
  2. 上記に記載したすべての場所に、古いトークン、APIキー、または認証文字列の代わりに設定してください。
  3. Agoraでプロフィールを編集から古いIdentityトークンを無効にします。

クイックリファレンス

AgoraのAPIキーのサポートは2026年2月に終了したため、Agoraはそれらを受け付けません。まだ保持しているものがあれば、Identityトークンに置き換えてください。

Agoraの使用方法 実行すること
Agoraウェブサイトへのサインイン あなたのAxeアカウントでサインインしてください。Agoraにサインインをご覧ください。
Identityトークン 新しいものを生成する。
Agora APIキー APIキーはもうサポートされていません。Identityトークンを生成するして、APIキーの代わりに使用してください。
npmまたはYarn（_authまたは_authTokenが.npmrcにある） ラインを再生成するを新しいIdentityトークンから。
docker loginをagora.dequecloud.com:1083に 再ログインするを新しいIdentityトークンで。
Maven、Gradle、NuGet、pip、またはBundler 保存されたパスワードを置き換えるを新しいIdentityトークンで。
Artifactory、Nexus、またはCIで使用されるサービスアカウント 新しいトークンを取得して保存されたコピーを更新する。

Agoraにサインイン

https://agora.dequecloud.com/に進みます。Agoraはauth.deque.comに送信し、そこであなたのAxeアカウントでサインインします。これは、https://axe.deque.comで使用するaxe DevToolsと同じアカウントです。貴社が独自のSSOを通じてAxeアカウントにサインインしている場合、Agoraもそれを使用します。

新しいIdentityトークンを生成する

  1. Agoraにサインイン。
  2. 上部バーのようこそ、あなたのメールアドレスボタンを選択し、次にプロフィールを編集を選択します。https://agora.dequecloud.com/ui/admin/artifactory/user_profileに直接進むこともできます。
  3. Identityトークンを生成するを選択します。オプションとして、「laptop npm」や「GitHub Actions」などの説明を追加し、その後次へを選択します。
  4. 今すぐトークンをコピーしてください。 これがその価値を確認する唯一の機会です。
important

Identity Tokenは1年で期限切れになります。それまでに交換するよう自分にリマインダーを設定してください。

ツールがユーザー名とパスワードを要求する場所では、Axeアカウントのメールアドレスをユーザー名として、Identity Tokenをパスワードとして使用してください。

tip

各マシンやパイプラインごとに別々のトークンを作成します。そうすることで、1つが漏洩しても、他に影響を与えることなくプロフィールを編集からそれを取り消すことができます。

npmとYarn

Agoraに対する.npmrcの行には、トークン自体が含まれています。_auth文字列は、あなたのメールとトークンのエンコードされたコピーですので、それも再生成が必要です。

最も簡単な方法： あなたのメールと新しいIdentity TokenをAgoraパッケージへのアクセスを設定するツールに貼り付けます。それから、.npmrcにあるAgoraの行をツールが生成するものと置き換えてください。

手動で： 新しい認証文字列を生成します：

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

その後、.npmrcにある各Agoraレジストリの古い_auth値を通常devtools-npmまたは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

_authTokenを使用している場合は、代わりに新しいIdentity Tokenを設定してください：

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

Yarn 2以降： npmAuthIdent（またはnpmAuthToken）を更新し、.yarnrc.yml内のAgoraスコープ用にします。

CIで： パイプラインが.npmrcに書き込むシークレットを更新します。

Docker

例えば、axe DevTools Linterイメージのようにagora.dequecloud.com:1083からイメージをプルする場合は再ログインしてください。Axeアカウントのメールと新しいIdentity TokenをAPIキーではなく使用してください：

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

Identity Tokenを貼り付け、Enterを押してからCtrl+D（WindowsではCtrl+Z、その後Enter）を押します。

CIでは、docker loginステップが使用するシークレットを更新します。

ダウンロードしてdocker loadするイメージtarは、他のダウンロードと同じように動作します。curl、スクリプト、およびCIでのダウンロードを参照してください。

Maven、Gradle、NuGet、PyPI、Ruby gems

それぞれの場合で、古いIdentity TokenやAPIキーを新しいIdentity Tokenに置き換えてください：

  • Maven： ~/.m2/settings.xmlにおいて、<password>の<server>の<id>がdeque。

  • Gradle（axe DevTools Mobile）： agora_identity_tokenをGradleプロパティに追加します。以前の指示に従ってまだartifactory_apikeyを持っている場合は、Identity Tokenに切り替えてください。

  • NuGet：

    • nuget.configで、Agoraソース用のpackageSourceCredentials下にClearTextPasswordを更新します。
    • Visual Studioで、Windows認証情報マネージャーからagora.dequecloud.comに対する保存済みの資格情報を削除し、プロンプトが表示されたら新しいトークンで再度サインインします。
    • 暗号化されたパスワードを使用している場合は、それも置き換えてください。

  • PyPI： update the token in the devtools-python index URL in pip.conf, or in PIP_EXTRA_INDEX_URL. If your email contains @, URL-encode it as %40.

  • Ruby gems：

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

サービスアカウントとリポジトリマネージャー

ArtifactoryまたはNexusインスタンスがAgoraをプロキシする場合や、CIが専用のAgoraサービスアカウントを使用する場合：

  1. サービスアカウント用の新しいIdentity Tokenを取得してください。アカウントの所有者はそれを生成できます。それ以外の場合は、Dequeに依頼して、アカウントが設定されたときと同様に発行してもらってください。
  2. リモートまたはプロキシリポジトリに保存されている資格情報、またはCIのシークレットを更新します。あなたのArtifactoryを設定するまたはあなたのNexusを設定するを参照してください。
  3. 認証情報が最新ではない間にキャッシュされた401応答をキャッシュしている場合は、リポジトリマネージャーの失敗したリクエストのキャッシュをクリアします。

curl、スクリプト、およびCIでのダウンロード

スクリプトやCIシークレット内の古いトークンまたはAPIキーをAGORA_IDENTITY_TOKENなどで置き換えてください。それが新しいIdentity Tokenである限り、スクリプトがそれをX-JFrog-Art-Apiヘッダーで送信しても動作し続けます：

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

Authorization: Bearer $AGORA_IDENTITY_TOKENも機能します。

warning

スクリプトやCIシークレットがまだAPIキー（AKCpで始まる）を保持している場合、そのヘッダーではAgoraに拒否されます。Identity Tokenに置き換えてください。

お困りですか？

Dequeの担当者に直接連絡するか、Dequeヘルプセンターを通じてサポートリクエストを送信してください。Axeアカウントのメールアドレスと使用しているツールを含めてください。

caution

絶対にIdentity Tokenやパスワードを送信しないでください。 Dequeはメールでパスワードやトークンの送信を依頼することは決してありませんので、そのようなメッセージがDequeから来たと主張される場合は注意が必要です。

Is this page helpful?

Help us improve this page

Still need help?