> ## 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 Account Setup

> 管理者が作成したサービスアカウントを Connect AI で設定し、利用を開始します。

サービスアカウントは、人間のユーザーを介さずに認証するために OAuth 2.0 Client Credentials フローを使用します。管理者がサービスアカウントを作成した後、以下の手順に従って認証を行い、リクエストを発行します。

## 前提条件

開始する前に、以下を確認してください：

* Administrator がサービスアカウントを作成し、**Client Id** と **Client Secret** を共有していること。これらの認証情報は、サービスアカウントの作成時に一度だけ表示されます。サービスアカウントの作成手順については、[**Service Accounts**](/ja/Service-Accounts) を参照してください。
* サービスアカウントに、データコネクションまたはワークスペースに対する権限が少なくとも 1 つ割り当てられていること。Administrator は **Edit Service Account** ページから権限を設定します。詳細については、[権限とアクセス制御](/ja/Permissions) を参照してください。
* サービスアカウントのステータスが **Active** であること。非アクティブなサービスアカウントは認証できません。

<Note>
  **Client Secret** をお持ちでない場合は、Administrator に依頼して **Users** ページの [**Service Accounts**](/ja/Service-Accounts) タブからサービスアカウントの認証情報をローテーションしてもらってください。新しいシークレットは認証情報のローテーション直後に表示されます。シークレットは一度しか表示されません。
</Note>

## 認証

Authentication ガイドの [OAuth 2.0 Client Credentials](/ja/API/Authentication#oauth-client-credentials) の手順に従って、ベアラートークンを取得し、最初の API 呼び出しを行います。

## セットアップの検証

権限を持つコネクションに対してクエリを実行します。成功レスポンスが返れば、サービスアカウントの認証が完了し、利用可能な状態であることが確認できます。

リクエストが失敗した場合は、以下を確認してください：

* **トークンの有効期限切れ**：トークンは `expires_in` の期間経過後に失効します。新しいトークンをリクエストして再試行してください。
* **権限の不足**：サービスアカウントには、クエリ対象のコネクションに対する権限が必要です。Administrator に連絡し、**Users** ページの [**Service Accounts**](/ja/Service-Accounts) タブで権限を確認または更新してください。
* **非アクティブなアカウント**：サービスアカウントのステータスは **Active** である必要があります。Administrator は **Users** ページの [**Service Accounts**](/ja/Service-Accounts) タブからステータスを確認および更新できます。