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

# Bitbucket Cloud

> HTTP Basic 認証で Atlassian API トークンを使用して Bitbucket Cloud を Iru Compliance に接続し、ワークスペース、リポジトリ、プルリクエストのレビューのエビデンスを収集します。

### Bitbucket Cloud について

**Bitbucket Cloud** コネクタは、変更管理やアクセスレビューに関して監査で求められる**リポジトリ**、**ワークスペース**、**プロジェクト**、**チーム**のメタデータを収集します。Iru は **HTTP Basic 認証**で認証します。ユーザー名には **Atlassian アカウントのメールアドレス**、パスワードには **Atlassian API トークン**を使用します（通常のパスワードは拒否されます）。

### 仕組み

クライアントは Base64 でエンコードされた認証情報を送信します。

```http theme={null}
Authorization: Basic base64(email:api_token)
```

Atlassian は**アプリパスワードを非推奨**にしています。新しい作業には **API トークン**を作成し、従来のシークレットを使用しているものは廃止される前に移行してください。

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | Basic 認証（メールアドレス + API トークン） |

ドキュメント: [API トークンの管理](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)、[Bitbucket API トークン](https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/)、[REST の概要](https://developer.atlassian.com/cloud/bitbucket/rest/intro/)。

### 前提条件

* エビデンスの取得対象となる Bitbucket **ワークスペース**へのアクセス権。
* Atlassian ID で **API トークン**を作成する権限。

### Bitbucket Cloud を Iru に接続する

<Tabs>
  <Tab title="Bitbucket Cloud">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="Atlassian アカウントの設定を開く">
        Bitbucket Cloud（または同じ Atlassian アカウントの任意の Atlassian アプリ）にサインインした状態で、**プロファイルアイコン**を選択し、**Account settings**（**Atlassian account** と表示される場合もあります）を選択します。
      </Step>

      <Step title="セキュリティと API トークンを開く">
        **セキュリティ** を選択し、**Create and manage APIトークン**（**APIトークン** と表示される場合もあります）を選択します。
      </Step>

      <Step title="スコープ付きの API トークンを作成する">
        **Create API token with scopes**（または最も近い項目）を選択します。ここでは、Iru での Basic 認証に Bitbucket が受け付ける Atlassian API トークンを作成します。
      </Step>

      <Step title="トークンを設定する">
        トークンにラベル（例: **Iru Compliance**）を付けます。有効期限を選択します（トークンの有効期間は最長 **365 日**です）。コントロールが参照する内容に合わせて、リポジトリ、ワークスペース、チームに対する**読み取り**スコープを付与します。
      </Step>

      <Step title="トークンをコピーする">
        トークンを作成し、値を**すぐに**コピーします。Atlassian では一度しか表示されません。Iru の **資格情報を送信** の手順で、Atlassian のメールアドレスとともに使用します。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Bitbucket Cloud**](#bitbucket-cloud) タブを完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Bitbucket をオンにする">
        **Bitbucket** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="Basic 認証情報を入力する">
        ウィザードで Basic 認証を求められたら、ユーザー名に **Atlassian のメールアドレス**、パスワードに **API トークン**を入力します。
      </Step>

      <Step title="接続を完了する">
        **資格情報を送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Bitbucket** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
  </Accordion>

  <Accordion title="401 Unauthorized">
    Bitbucket のユーザー名や Atlassian のパスワードではなく、**メールアドレス + API トークン**を使用してください。
  </Accordion>

  <Accordion title="トークンの有効期限が切れている">
    Account settings で新しいトークンを発行し、Iru を更新してください。
  </Accordion>

  <Accordion title="ワークスペースが表示されない">
    データを取得するすべてのワークスペースに Atlassian アカウントが所属していることを確認してください。
  </Accordion>

  <Accordion title="従来のアプリパスワード">
    API トークンに置き換えてください。アプリパスワードは非推奨です。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="トークンには有効期限があるため、カレンダーのリマインダーで…" icon="circle-info">
    トークンには有効期限があります。カレンダーのリマインダーを設定しておくと、気付かないうちに接続が停止することを防げます。
  </Card>

  <Card title="読み取りスコープにより、Iru がリポジトリやプル…" icon="shield">
    読み取りスコープにより、Iru がリポジトリやプルリクエストを変更することはありません。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照・管理します。
  </Card>

  <Card title="Compliance の利用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>