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

# Buildkite

> BuildkiteとAdminaをAPIキーで連携する手順です。ユーザー名・メールアドレス・ロールなどを取得し、Adminaからサービスアカウントの作成・削除ができます。

## 連携仕様

<dl />

## 事前準備

### APIアクセストークンの取得方法

1. [Buildkite](https://buildkite.com)にログインし、画面上部で連携する組織が選択されていることを確認します。右上のプロフィールメニューを開き、**Personal settings**（個人設定）をクリックします。

   ![Buildkiteのプロフィールメニューで Personal settings が示されている状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-personal-settings.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=e3e601849ac99bb804270b608d57d19c)

2. 左メニューの**API Access Tokens**（APIアクセストークン）を選択します。

   ![Buildkiteの個人設定の左メニューで API Access Tokens が示されている状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-api-access-tokens-menu.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=b4b6898546580e51506e5bd78a50d06d)

3. **New API Access Token**（新しいAPIアクセストークン）をクリックします。

   ![BuildkiteのAPI Access Tokens画面で New API Access Token ボタンが示されている状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-new-api-access-token.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=622604dff316f251fb2d4f824f7e5b47)

4. **Description**（説明）にトークンの用途が分かる名前を入力します。**Organization Access**（組織へのアクセス）では連携する組織を選択します。**Token Expiry**（トークンの有効期限）は、**Never**（無期限）を選択します。画像では**7 days**が選ばれていますが、7日間などの期限を選ぶと、期限が切れた時点で連携が止まります。

   ![BuildkiteのNew API Access Token画面で Description、Organization Access、Token Expiry が示されている状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-create-token-settings.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=d25a29c3667b15b03e8367fce5fbd31a)

5. **REST API Scopes**（REST APIスコープ）の**Organization & Users**（組織とユーザー）を開きます。**Organizations**と**Organization Invitations**は**Read**と**Write**の両方に、**Teams**は**Read**にチェックを入れます。ほかの項目にはチェックを入れません。画像ではすべての項目にチェックが入り、**Teams**の**Write**にも赤枠が付いていますが、**Teams**の**Write**は不要です。

   ![BuildkiteのOrganization & Usersで Organizations、Organization Invitations、Teams の Read と Write のチェックが示されている状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/buildkite-token-scopes.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=645c2596780dde2177947cb47ae06a9a)

6. トークンを作成し、表示されたトークンをコピーします。

> [!NOTE]
>
> **Read**は、Buildkiteからメンバーの一覧を取得するために必要です。**Write**は、**Organizations**ではアカウントの削除に、**Organization Invitations**ではアカウントの作成（招待）に必要です。**Teams**は**Read**だけで足ります。**Write**には**Read**が含まれないため、**Write**を選ぶ項目では両方にチェックを入れてください。
>
> Buildkite社の「[Managing API access tokens（外部サイト）](https://buildkite.com/docs/apis/managing-api-tokens)」のとおり、**Organizations**の**Write**ではメンバーの削除、**Organization Invitations**の**Write**では招待の作成と取り消し、**Teams**の**Read**ではチームの取得ができます。

## インテグレーションのセットアップ

1. インテグレーション画面にて**Buildkite**を検索します。

2. 前の手順で作成したトークンを**APIキー**に入力し、**連携する**をクリックします。

   ![Buildkite連携画面でAPIキーを入力する状態](https://mintcdn.com/moneyforwardi/-Ff5k1r2A7v3Udje/images/integrations/buildkite/admina-buildkite-setup.png?fit=max\&auto=format\&n=-Ff5k1r2A7v3Udje\&q=85\&s=1a882b1918f2a75f9d6d5cc1d3ac7191)

3. Buildkiteとの連携が成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。正常に完了しない場合は、まず [SaaS連携エラーの対処法](https://support.i.moneyforward.com/it-management/saas-management/93nahw45is-trouble.md) に記載のステップをお試しください。それでも解決しない場合は、[ご提供いただきたい情報](https://support.i.moneyforward.com/it-management/saas-management/93nahw45is-trouble.md#info-to-provide) をご確認のうえ、[サポート窓口](https://support.i.moneyforward.com/contact-support.md)までお問い合わせください。


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