3.8.1 認証情報の登録

自動化で登録した認証情報は、ジョブを実行する対象ホストのシークレット情報を管理します。
ここでは、以下の認証情報の登録方法について説明します。
（1）シークレットとGitLabにアクセスするための認証情報
（2）PATを使用した認証情報

（1）シークレットとGitLabにアクセスするための認証情報

シークレットとGitLabにアクセスするための認証情報の登録方法について説明します。
認証情報の登録を行うにあたって、事前にGitLabアクセストークンをシークレットに格納し、そのシークレットの情報を取得する必要があります。下表に必要な取得項目と参照先を示します。

（表）認証情報登録のため事前に取得する情報一覧

項目 参照先
  • secrets Engine名
 Secrets Engines作成
  • シークレットへのパス（「Path for this secret」に入力した任意のパス）
  • キー名（「Secret data」に入力した任意のkey）
 Secretの作成
  • AppRoleのロールID
  • AppRoleのシークレットID
 自動化からシークレットにアクセスするための認証情報の取得

【シークレットにアクセスするための認証情報の登録手順】

シークレットにアクセスするための認証情報の登録手順を示します。

1. 自動化アプリケーションを選択し、コンテンツエリアに表示されたAWXの画面で「リソース」カテゴリーの「認証情報」を選択します。
2. 認証情報画面が表示されるので追加ボタンをクリックすると、新規認証情報の作成画面が表示されるので必要な情報を入力します。

（図）新規認証情報の作成画面（認証情報タイプ「HashiCorp Vault Secret Lookup」）

（図）新規認証情報の作成画面（認証情報タイプ「HashiCorp Vault Secret Lookup」） （図）新規認証情報の作成画面（認証情報タイプ「HashiCorp Vault Secret Lookup」）


（表）シークレットにアクセスするための新規認証情報の作成画面入力情報一覧

項目 説明
名前 シークレットにアクセスするための認証情報の名前
「Outpost」は予約語のため使用不可
認証情報タイプ シークレットにアクセスする場合は「HashiCorp Vault Secret Lookup」を選択
サーバーURL http://vault.テナント名-service:8200
テナント名はPlaybookをもっているテナント名に置き換える。
AppRole role_id 事前にシークレットで取得したAppRoleのロールID
AppRole secret_id 事前にシークレットで取得したAppRoleのシークレットID
認証へのパス approle（デフォルト）
API バージョン v2を選択
3. 保存ボタンをクリックします。

【GitLabへアクセスするための認証情報の登録手順】

GitLabへアクセスするための認証情報は、認証情報タイプ「ソースコントロール」で登録します。「ソースコントロール」の認証情報から、「HashiCorp Vault Secret Lookup」の認証情報を参照することにより、シークレットからキーをとってくることができGitLabへアクセスできるようになります。

1. 自動化アプリケーションを選択し、コンテンツエリアに表示されたAWXの画面で「リソース」カテゴリーの「認識情報」を選択します。
2. 認証情報画面が表示されるので追加ボタンをクリックすると、新規認証情報の作成画面が表示されるので必要な情報を入力します。

（図）新規認証情報の作成画面（認証情報タイプ「ソースコントロール」）

（図）新規認証情報の作成画面（認証情報タイプ「ソースコントロール」） （図）新規認証情報の作成画面（認証情報タイプ「ソースコントロール」）


（表）「HashiCorp Vault Secret Lookup」参照のための新規認証情報の作成画面入力一覧

項目 説明
名前 認証情報タイプ「HashiCorp Vault Secret Lookup」の認証情報を参照するための認証情報の名前
「Outpost」は予約語のため使用不可
認証情報タイプ GitLabにアクセスするため「ソースコントロール」を選択
ユーザー名 シークレットの認証情報の登録を行ったユーザー名
パスワード 以下の手順で設定します。
  • パスワード入力欄のカギマークをクリックする。
  • 外部シークレット管理システムの認証情報選択画面が表示され、作成済みの認証情報一覧が表示されるので、【シークレットにアクセスするための認証情報の登録手順】で作成した認証情報を選択して次へをクリックする。
  • メタデータ入力画面に遷移するので、必要なシークレット情報を入力する。入力情報の詳細は「（表）外部シークレット管理システムのメタデータ入力一覧」参照。
  • テストボタンをクリックして、GitLabにアクセスできるか確認する。
  • OKをクリックする。

（図）外部シークレット管理システム画面

（図）外部シークレット管理システム画面 （図）外部シークレット管理システム画面


（表）外部シークレット管理システムのメタデータ入力一覧

項目 説明
シークレットバックエンドの名前 Secret Engine名
シークレットへのパス 事前にシークレットで取得したシークレットへのパス
認証へのパス 新規認証情報の作成画面の「認証へのパス」と同じパラメータ
キー名 事前にシークレットで取得したキー名

3. 必要な情報の入力が完了したら保存ボタンをクリックします。


（2）PATを使用した認証情報

PAT（Personal Access Token）は、Ops I提供部品が自動化にアクセスするための認証情報です。
PATを使用する場合、ユーザー情報（ユーザー名、ユーザーのパスワード）が不要です。これにより、Ops I内部でユーザー情報（ユーザー名、ユーザーのパスワード）を保持しないため、外部IdP連携において、外部IdPでユーザー情報を一括管理することができます。
Ops I提供部品については「Ops I提供部品」、外部IdP連携については「外部IdP連携の設定」を参照してください。

[PATの作成手順]

PATの作成は、PATを使用するユーザー自身で実施します。

  1. 自動化アプリケーションを選択し、コンテンツエリアに表示されたAWXの画面で「アクセス」-「ユーザー」を選択します。
  2. ユーザー一覧が表示されるので、トークンを取得するユーザーを選択します。
  3. ユーザーの詳細画面が表示されるので、「トークン」タブの追加ボタンをクリックします
  4. ユーザートークン作成画面が表示されるので、「範囲」項目で「書き込み」を選択し、保存ボタンをクリックするとトークンが発行されます。
  5. トークンが発行され、画面に表示されます。他の画面に遷移するとトークンは確認することができなくなるので、メモなどで保存してください。

作成したPAT（手順5.で発行されたトークン）をシークレット管理に保存してください。シークレット情報の登録については「シークレットの登録」を参照してください。

PATの有効期限は1,000年のため、基本的に更新は不要です。
PATを更新する場合は、新たにPATを作成し、シークレットに格納されている古いPATを新しく作成したPATに置き換えてください。シークレットで新しいPATに置き換える前に作成したワークフローがすべて終了した後、古いPATを自動化から削除してください。