Nexusのセットアップ

DequeのAgoraアーティファクトリポジトリにNexusリポジトリインスタンスから接続する場合は、次の手順に従ってください。この認証されたリモートリポジトリをNexusにセットアップすることで、ユーザーは独自のソフトウェア配信ネットワークを通じてAxe DevToolsコンポーネントにアクセスできるようになります。

前提条件

このリポジトリ接続を構成するには、Agoraのログイン資格情報とNexusインスタンスの管理者資格情報が必要です。個人アカウントではなく、これらの資格情報にはAgoraサービスアカウントを使用することをDequeは推奨します。

サービスアカウントの利用

Deque は、Agora のログイン情報ではなく、Agora のサービスアカウントを使用してこの接続を認証することを推奨します。サービスアカウントとは、一人のチームメンバーの個人アカウントではなく、チームの所有となる Agora アカウントです。

リポジトリマネージャー — 設定しているリモートリポジトリをホストするサーバー — はサービスアカウントの資格情報を保持し、Agora へのアクセスが必要な際にそれを使用します。事前にパッケージをダウンロードすることはありません。開発者やビルドパイプラインが最初に Axe DevTools パッケージをインストールする際、リモートリポジトリは Agora からそのパッケージを取得し、コピーを保持します。その後のインストールは保持したコピーから提供されます。開発者や自動化されたシステムはリポジトリマネージャーからのみパッケージを要求するため、独自の Agora アカウントを必要としません。

個人のログインに基づく接続は、その人が Agora へのアクセスを保持することに依存しています。もしその人が組織を離れた場合には、アカウントにサインインして Identity Token を更新することはできず、インストールがすべて失敗します。サービスアカウントは一人に依存しません。

サービスアカウントの管理

サービスアカウントの Identity Token — アカウントのために Agora が発行する、パスワードに似た資格情報 — は共同インフラストラクチャ資格情報として扱い、組織のセキュリティポリシーおよび資格情報ポリシーに従って管理してください。秘密情報管理ツールや CI プロバイダの秘密ストアに保存し、ソース管理にコミットするのではなくリポジトリマネージャーの設定から参照してください。Deque に、必要に応じて読取り権限に制限するよう依頼し、漏洩した可能性がある場合やアカウントオーナーが変更された場合には、トークンの取り消しと再発行を依頼してください。

組織内からアカウントにオーナーを割り当ててください。Identity Token は有効期限があります（通常は1年後）ので、アカウントオーナーは期限切れ前にトークンを再作成する必要があります。再作成した人は、リポジトリマネージャーが Agora へ接続するために使用する保存済みトークンも更新する必要があります。そうしないと、新しいパッケージや更新されたパッケージをリポジトリマネージャーがダウンロードできません。

アイデンティティトークンの作成

まず、サービスアカウントとしてAgoraにサインインするしてください。そうすることで、Identity Tokenは個人アカウントではなくサービスアカウントに属するようになります。サービスアカウントを使用していない場合は、自分自身としてサインインしてください。プロフィールページを開くには、右上隅にあるようこそボタンをクリックしてください。そこでIdentity Tokenを生成し、それをコピーします。

Agoraへの接続

1. 管理者資格情報でNexusリポジトリマネージャーにサインインします。
2. Nexusリポジトリマネージャーのヘッダーにある歯車アイコンを選択します。リポジトリ管理ページが表示され、左側のサイドバーに管理メニューが表示されます。
3. リポジトリ（リポジトリの管理）を選択して、リポジトリページを表示します。
4. リポジトリページの上部でリポジトリ作成を選択します。
5. リポジトリページにはレシピの一覧が表示されます。レシピを選択テーブルでAxe DevToolsを使用したい言語のプロキシバージョンを選択します。
6. リポジトリ作成ページにはフォームが表示されます。次の点を除き、デフォルト設定を使用することをお勧めします:
   1. Axe DevTools用のリモートストレージロケーション:

      レシピ	このArtifactory URLを使用してください（選択するにはトリプルクリック）
      npm（プロキシ）	https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
      maven2（プロキシ）	https://agora.dequecloud.com/artifactory/devtools-maven/
      nuget（プロキシ）	https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
      rubygems（プロキシ）	https://agora.dequecloud.com/artifactory/devtools-gems/
      pypi（プロキシ）	https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/

   2. 認証ボックスの選択を確認し、HTTPセクションにユーザー名リストオプションが表示されていることに注意してください。
   3. サービスアカウントのメールアドレスをユーザー名として入力し、コピーしたIdentity Tokenをパスワードとして入力します。サービスアカウントを使用していない場合は、自分がサインインしたAgoraアカウントのメールアドレスを入力してください。
7. リポジトリ作成: <選択したレシピ>ページの左下隅でリポジトリ作成を選択します。
8. 成功すると、リモートリポジトリの作成を示すメッセージが表示されます。