Skip to main content

APIのみのユーザの作成

全てのプラグインやインテグレーションで使用できる、APIのみのユーザを作成します。

参考: ベストプラクティスとして、プラグインやインテグレーションを使用するためだけのユーザアカウントを登録することを推奨します。この専用ユーザにより、あるユーザが会社や組織を離れた際に、使用しているプラグインやインテグレーションが機能するよう継続できます。そのユーザアカウントが削除されて問題が発生するような状況を避けることができます。

APIのみのアカウントは、通知設定が有効になっている場合でも、電子メールの通知を受信しません。

インストールを行う前に

  • 組織のAdminロールが必要です。

  • APIのみのユーザは、ContrastのREST APIにアクセスできますが、Contrast Webインターフェイスにはログインできません。

  • SAML認証のSSO(シングルサインオン)を使用するように組織が構成されている場合でも、APIのみのユーザを作成できます。

手順

APIのみのユーザを作成するには:

  1. ユーザメニューから、組織の設定を選択します。

  2. ユーザを選択します。

  3. ユーザを追加を選択します。

    AddUserButtonEN.png
  4. ユーザの名前と名字、メールアドレスを入力し、タイムゾーンを選択します。

  5. 組織ロールを選択します。

    参考: ベストプラクティスとして、組織ロールには Edit を選択して、最小の許容ロールを付与します。

    APIのみのユーザにAdmin権限を付与することは推奨されません。

  6. アプリケーションアクセスグループを選択します。

    参考: ベストプラクティスとして、アプリケーションアクセスグループにはViewまたはEditを選択します。呼び出したいAPIエンドポイントや、GET(読み取り)やPOST(書き込み)を実行する場合によっては、APIのみのユーザにはViewではなく、より高いEdit権限が必要になることがあります。

  7. APIのみのチェックボックスを選択します。

    APIonly1EN.png

    注記

    APIのみのチェックボックスをオンにすると、アクセスのオプションがオンになっている場合は無効になります。APIのみのユーザは、Contrast Webインターフェイスにアクセスできません。

  8. 組織の設定 > ユーザで、新規に作成したユーザ名の横にAPIのみのラベルがあることを確認します。

    APIonly2EN.png
  9. 特定のアプリケーションに対してアクセスを制限するためにアクセスグループを使用している場合は、APIユーザにアクセスさせたいアプリケーションのグループに、APIのみのユーザを追加します。ユーザの設定の権限でアクセスを確認してください。

  10. APIのみのユーザを使用するには、接続文字列を取得します。

    1. ユーザメニューから、組織の設定を選択します。

    2. ユーザを選択します。

    3. ユーザ名の横にあるAPIのみのラベルにカーソルを合わせ、表示されたサービスキーをコピーします。

    4. 以下の例のように、コマンドを使用して認証ヘッダを作成します。

      echo -n ‘[email address of the API only account:Service Key]’ | base64