> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Service Accounts

> ***Identities*** ページの**Service Accounts** タブでは、Connect AI アカウントの非人間 ID を管理できます。

**Service Account** は、エージェントなどの非人間 ID で、Connect AI と対話する権限を持ちます。サービスアカウントは OAuth 2.0 Client Credentials で認証されます。スクリプト、ジョブ、外部サービスにプログラム的なアクセスを付与するために使用します。

<Frame>
  <img src="https://mintcdn.com/cdata/zsa1-n4yLfw8Vgp3/ja/images/service_accounts.png?fit=max&auto=format&n=zsa1-n4yLfw8Vgp3&q=85&s=158b801842f9d7d0ecca6374128348f1" alt="Service Accounts" width="903" height="445" data-path="ja/images/service_accounts.png" />
</Frame>

**Service Accounts** タブには以下の情報が含まれます：

* サービスアカウント名を入力するための検索バー。
* ワークスペース名とサービスアカウントのステータスで絞り込むためのドロップダウンリスト。
* アカウント内のすべてのサービスアカウントの行：
  * **Name** はサービスアカウントの名前です。
  * **Workspace** はサービスアカウントを含むワークスペースを表示します。
  * **Client Id** は OAuth 2.0 Client Credentials 経由でサービスアカウントを認証するために使用される一意の識別子です。
  * **Status** はサービスアカウントのステータス（active または inactive）です。サービスアカウントを非アクティブ化すると、その認証情報を使用しているサービスや自動化は、次回のリクエストで失敗します。監査目的のため、サービスアカウント自体はレジストリに残ります。
  * **Created** はサービスアカウントが作成された日時です。
  * サービスアカウントのローテーション、編集、削除アイコン。認証情報をローテーションすると、現在の認証情報はすぐに動作しなくなります。次回のリクエスト前に、依存するサービスを更新する必要があります。

## サービスアカウントの追加

<Steps>
  <Step>
    **Identities** ページの **Service Accounts** タブで **+ Add Account** をクリックして、
    **Add Service Account** ページを開きます。

    <Frame>
      <img src="https://mintcdn.com/cdata/KfMuIQJ-a8LDjItS/ja/images/add_service_account.png?fit=max&auto=format&n=KfMuIQJ-a8LDjItS&q=85&s=c3c92bd31abd6e619aadb3e344c06f19" alt="Add a Service Account" width="601" height="497" data-path="ja/images/add_service_account.png" />
    </Frame>
  </Step>

  <Step>サービスアカウントの **Name** を入力します。</Step>
  <Step>サービスアカウントの簡単な **Description** を入力します。</Step>

  <Step>
    **Authentication Type** として **Client Secret** または **Public Key** を選択します。
    **Public Key** を選択した場合、公開鍵（PEM）ファイル（RS256 または ES256）のアップロードを求められます。
  </Step>

  <Step>**Confirm** をクリックしてサービスアカウントを保存します。</Step>

  <Step>
    **Client Secret** を選択した場合、**Add Service Account** ダイアログが表示されます。
    **Client Id** と **Client Secret** をコピーします。**Client Secret** は一度しか表示されません。

    <Note>
      OAuth 2.0 を使用してサービスアカウントを認証する開発者とこれらの認証情報を共有します。詳細については、
      [Service Account Setup](/ja/API/Service-Account-Setup) を参照してください。
    </Note>
  </Step>

  <Step>
    **Done** をクリックします。**Edit Service Account** ページが表示されます。

    <Frame>
      <img src="https://mintcdn.com/cdata/3NdGpyOzvnu58iey/ja/images/edit_service_account.png?fit=max&auto=format&n=3NdGpyOzvnu58iey&q=85&s=725cac78cd76209587560ce5e94e1aa0" alt="Edit a Service Account" width="923" height="823" data-path="ja/images/edit_service_account.png" />
    </Frame>
  </Step>

  <Step>
    （オプション）アクセスを適用する**Workspace** を選択します。
  </Step>

  <Step>
    （オプション）サービスアカウントを別のワークスペースに追加するには、**+ Add to Workspace** をクリックします。詳細については、[サービスアカウントのワークスペースへの追加](#サービスアカウントのワークスペースへの追加)を参照してください。
  </Step>

  <Step>
    （オプション）サービスアカウントに **Access Role** を追加します。アクセスロールを選択すると、
    以下のエンティティの **Permissions** が自動的に更新されます。
  </Step>

  <Step>
    （オプション）**Permissions** で、Connect AI インスタンス内のエンティティ
    （データコネクションおよび仮想スキーマ）に対するサービスアカウントの権限を手動で選択します。
    権限の詳細については、[権限とアクセス制御](/ja/Permissions) を参照してください。
  </Step>

  <Step>
    **Save Changes** をクリックして、サービスアカウントの設定を保存します。
  </Step>
</Steps>

## サービスアカウントの編集

**Service Accounts** リストのローテーション、編集、または削除アイコンをクリックすることで、任意のサービスアカウントを変更したり、認証情報をローテーションしたり、サービスアカウントを削除したりできます。

**Edit Service Account** ページで、以下の操作ができます：

* **Name** および **Description** フィールドを編集する。
* サービスアカウントをワークスペースに追加する。
* 選択したワークスペースのアクセスロールを追加および削除する。
* 選択したワークスペースの権限を手動で更新する。
* 認証情報をローテーションする（現在の認証情報はすぐに動作しなくなります）。
* サービスアカウント全体を削除する。

## サービスアカウントのワークスペースへの追加

ワークスペース内でサービスアカウントにアクセスロールを割り当てるには、事前にそのサービスアカウントをワークスペースに追加しておく必要があります。

<Steps>
  <Step>
    **Edit Service Account** ページの**Workspaces** セクションで、**+ Add to Workspace** をクリックして**Add Service Account to Workspace** ダイアログを開きます。
  </Step>

  <Step>
    サービスアカウントを追加する**Workspace** を選択します。**Next** をクリックします。
  </Step>

  <Step>
    ワークスペース内のサービスアカウントに**Access Role** を選択します（任意）。アクセスロールの作成については、[Roles](/ja/Identities/Roles) を参照してください。
  </Step>

  <Step>
    **Add** をクリックして、サービスアカウントをワークスペースに追加します。
  </Step>
</Steps>

## サービスアカウントの削除

サービスアカウントを削除するには、**Edit Service Account** ページで**Delete** をクリックします。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.