サービスユーザー

サービスユーザーを利用することで、Advanced Server Accessの次のような操作に自動的にアクセスする権限を付与できるようになります。

  • 自分のインフラストラクチャにアクセスする権限を信頼できるサービスに付与できるようにする
  • Advanced Server Access APIに統合してユーザーを自動的にグループに追加する
  • Advanced Server AccessのAPIから監査イベントを取得してELKセットアップに格納する
  • Advanced Server AccessのAPIを使ってその他のカスタム統合を構築する

サービスユーザーをグループに追加して、通常ユーザーと同じ権限を付与できます。ユーザーとサービスユーザーの主な違いは、それぞれの認証方法にあります。

ユーザーは、認証を処理するOktaからプッシュされます。サービスユーザーには、APIで使用される短時間のみ有効な認証トークンの生成に使用される1ペアの資格情報が与えられます。

認証

Advanced Server Access APIのサービスユーザーとして認証するには、APIキーを作成する必要があります。APIキーは、IDとシークレットとして認識される1ペアの文字列です。認証には両方の情報が必要であり、リクエストのたびに送信される認証トークンが生成されます。

サービスユーザーとAPIキーを作成する

  1. Advanced Server Accessダッシュボードでユーザー(Users)をクリックします。
  2. サービスユーザー(Service Users)タブを選択します。
  3. サービスーザーを作成する(Create Service User)をクリックします。サービスーザーを作成する(Create Service User)ページが表示されます。
  4. サービスユーザーのユーザー名を入力します。LinuxおよびWindowsの対応ユーザー名が自動的に作成されます。サービスユーザーを作成する(Create Service User)をクリックすると、サービスユーザーが作成されます。
  5. API キーを作成する(Create API Key)をクリックします。ローテーションされたAPIキーシークレット(API Key Secret Rotated)ページが表示されます。
  6. このページでAPIキーIDとAPIキーシークレットをコピーして保存します。注:ウィンドウを閉じると、この情報は得られなくなります。この情報をなくしたときは、クライアントIDとシークレットを新たに生成しなおす必要があります。

サービスユーザーのAPIキーを期限切れにする

APIキーを期限切れにすると、キーを使って生成されたトークンを使用するリクエストは、直後から失敗するようになります。

サービスユーザーのAPIキーを期限切れにするには:

  1. Advanced Server Accessダッシュボードでユーザー(Users)をクリックします。
  2. サービスユーザー(Service Users)タブを選択します。
  3. キーを期限切れにするサービスユーザーの名前をクリックします。サービスユーザーの詳細ページが表示されます。
  4. 期限切れにするキーのIDの横に表示されるギア(gear icon)をクリックします。今すぐ期限切れにする(Expire Now)をクリックします。APIキーを期限切れにする(Expire API Key)ウィンドウが表示されます。
  5. 期限切れ(Expire)をクリックしてAPIキーIDを期限切れにします。操作をキャンセル場合は、x buttonをクリックします。

関連項目