13.2.11. GitHub App のインストールアクセストークン検索の 設定
このプラグインを使用すると、GitHub App の RSA 秘密鍵を認証情報入力ソースとして使用し、GitHub App のインストールからアクセストークンを取得できます。プラットフォームゲートウェイは、組織の GitHub リポジトリーからの既存の GitHub 認可を使用します。
詳細は、Generating an installation access token for a GitHub App を参照してください。
手順
- シークレットを保存するルックアップ認証情報を作成します。詳細は、新しい認証情報の作成 を参照してください。
認証情報タイプ として GitHub App インストールアクセストークン検索 を選択し、以下の属性を入力して検索を適切に設定します。
- GitHub AppID:GitHub インスタンスから提供されたアプリ ID を入力してください。これは認証に使用されます。
- GitHub App のインストール ID: アクセストークンが適用される対象組織のアプリケーションの ID を入力してください。ターゲットリポジトリーにアクセスできるようにこの属性を設定する必要があります。
- RSA 秘密鍵:GitHub インスタンスが生成した秘密鍵を入力してください。これは GitHub 内の GitHub App メンテナーから入手できます。詳細は、Managing private keys for GitHub Apps を参照してください。
をクリックして、認証情報を確認して保存します。
以下は、設定済みの GitHub App インストールアクセストークン検索 認証情報の例です。
ルックアップ認証情報を検索するターゲット認証情報を作成します。プライベートリポジトリーでルックアップを使用するには、認証情報の種類 として ソース管理 を選択してください。次の属性を入力して、ターゲット認証情報を適切に設定します。
-
ユーザー名: ユーザー名
x-access-tokenを入力してください。 パスワード: 入力フィールドの
アイコンをクリックして、外部認証情報を管理してください。機密情報の取得に使用する入力ソースを設定するように求められます。これはすでに作成したルックアップ認証情報です。
-
ユーザー名: ユーザー名
- 要求されるメタデータの説明を必要に応じて入力し、 をクリックします。
- をクリックして、認証情報を確認して保存します。
検索に使用した認証情報と、目的の認証情報の両方が、認証情報 リストビューに表示されていることを確認してください。プロジェクトでターゲット認証情報を使用するには、プロジェクトを作成し、次の情報を入力します。
- 名前: プロジェクトの名前を入力してください。
- 組織: ドロップダウンメニューから組織名を選択してください。
- 実行環境: 必要に応じて、実行環境を選択してください。
ソース管理の種類: プライベートリポジトリーと同期する場合は、ソース管理に Git を 選択してください。
追加入力を行うための タイプ詳細 ビューが開きます。以下の情報を入力します。
- ソース管理 URL: アクセスしたいプライベートリポジトリーの URL を入力してください。ブランチ、タグ、コミット、参照指定 に関するその他の関連フィールドは、ルックアップ認証情報で使用する際には関係ありません。
ソース管理認証情報: すでに作成済みの対象認証情報を選択してください。
以下は、プロジェクトで設定したターゲット認証情報の例です。
をクリックすると、プロジェクトの同期が自動的に開始します。プロジェクトの 詳細 タブには、作業の進捗状況が表示されます。
トラブルシューティング
プロジェクトの同期が失敗した場合は、手順 2 の GitHub API エンドポイント URL フィールドに https://api.github.com を 手動で再入力し、プロジェクトの同期を再度実行する必要があるかもしれません。