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

# サービスアカウント

> CI/CDパイプライン、スクリプト、Droid ComputersでFactoryの自動化を実行するための人以外のID。

サービスアカウントは、組織に代わって作業を自動化する人以外のIDです。CI/CDパイプライン、スクリプト、Slack自動化、Droid Computersなど、特定のチームメイトではなく組織にワークロードを紐づけるべき場合に使用します。

<Info>
  **Enterprise機能** — サービスアカウントはエンタープライズ顧客が利用できます。詳細については[お問い合わせください](mailto:sales@factory.ai)。
</Info>

***

## まずは基本から

<CardGroup cols={2}>
  <Card title="サービスアカウントを作成" icon="user-plus">
    SettingsのAPIキーセクションから安定したIDを追加します。実行内容がチームに分かるよう、明確な名前と必要に応じた説明を付けてください。サービスアカウントを作成または編集できるのは、マネージャーとオーナーのみです。
  </Card>

  <Card title="APIキーを生成" icon="key">
    スクリプト、CIジョブ、その他の自動化ワークロード用のキーを作成します。キーの値は一度しか表示されないため、コピーして安全に保管してください。
  </Card>

  <Card title="Droid Computersを関連付ける" icon="server">
    サービスアカウントが所有するコンピューターを作成し、長時間実行される作業を同じIDのまま継続できるようにします。
  </Card>

  <Card title="Gitアクセスを設定" icon="code-branch">
    GitHubには組織のGitHub Appインストールを使用します。GitLab Cloudでは、Settingsにサービスアカウント用のGitLabトークンを追加します。
  </Card>
</CardGroup>

***

## サービスアカウントの仕組み

サービスアカウントはFactory APIキーで認証され、独立したプリンシパルとして実行されます。セッション、コンピューター、課金イベント、監査関連の情報は、人間のユーザーではなくサービスアカウントに紐づけられます。

サービスアカウントが認証に使用されるには、有効である必要があります。無効にしたり削除したりすると、そのキーを使う新しいリクエストは失敗し、そのIDに依存するワークロードは別のアカウントへ移行するか、別のアカウントで再起動する必要があります。

***

## アクセスを安全に管理する

<AccordionGroup>
  <Accordion title="可能なら短命なキーを使う">
    一時的な自動化で使うキーには有効期限を設定します。誤ってキーが漏えいしても、短命なキーであれば影響範囲を抑えられます。
  </Accordion>

  <Accordion title="キーを定期的にローテーションする">
    新しいキーを作成し、ワークロードを更新してから古いキーを失効させます。定期的なローテーションにより、認証情報が侵害された場合のリスクを減らせます。
  </Accordion>

  <Accordion title="名前は固定して使う">
    サービスアカウント名は変更できない識別子です。別の名前が必要な場合は、新しいサービスアカウントを作成してください。
  </Accordion>

  <Accordion title="不要になったら削除する">
    サービスアカウントを削除するとアクセス権が取り消され、可能な範囲でそのアカウントが所有するFactoryリソースも整理されます。
  </Accordion>
</AccordionGroup>

***

## 一般的なユースケース

<CardGroup cols={2}>
  <Card title="CI/CD" icon="gear">
    あるエンジニア1人のアカウントに依存せず、リリース、テスト、デプロイのワークフローを実行します。
  </Card>

  <Card title="Slack自動化" icon="message">
    チャンネルやワークフローを設定して、Droidをチーム共有のIDとして実行します。
  </Card>

  <Card title="リポジトリ自動化" icon="code">
    サービスアカウントで管理される認証情報を使って、リポジトリのclone、push、各種操作を行います。
  </Card>

  <Card title="永続的なコンピューター" icon="desktop">
    Droid Computersを、チームメイト個人のアカウントではなく自動化用IDに紐づけたまま維持します。
  </Card>
</CardGroup>
