> ## 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.

# Confluence Cloud

> Atlassian のサブドメインと API トークンを使用して Confluence Cloud を Iru Compliance に接続し、スペース、ページの階層、アクセス権限のエビデンスを収集します。

### Confluence Cloud について

**Confluence Cloud** コネクタは、アクセスレビューや変更管理のエビデンスに必要な**スペース**、**ページ**、**メンバーシップ**のデータを収集します。ウィザードは 2 つのパートで構成されています。まず、Iru が `https://YOUR_SUBDOMAIN.atlassian.net/wiki/api/v2` にアクセスできるように **`*.atlassian.net`** のサブドメインを入力し、次に **Atlassian のメールアドレス**と **API トークン**から構成される **HTTP Basic** 認証情報を入力します。

### 仕組み

REST 呼び出しでは Basic 認証を使用します。

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

パスワードは受け付けられません。API トークンのみが使用できます。

| 項目 | 値 |
| - | - |
| **カテゴリ** | 生産性 |
| **認証** | Basic 認証（メールアドレス + Atlassian API トークン） |
| **対象範囲** | **Confluence Cloud** REST API v2（Data Center/Server は対象外） |

ドキュメント: [Confluence Cloud の Basic 認証](https://developer.atlassian.com/cloud/confluence/basic-auth-for-rest-apis/)、[REST v2 の概要](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/)、[API トークン](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)。

### 前提条件

* エビデンスの取得対象となる**スペース**へのアクセス権。
* お客様の**サブドメイン**（**`.atlassian.net`** の前にあるラベル。例: ユーザーが `https://acme.atlassian.net/wiki` にアクセスする場合は `acme`）。

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

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

    <Steps>
      <Step title="Atlassian API トークンを開く">
        Confluence Cloud で使用している**同じ Atlassian アカウント**にサインインした状態で、ブラウザで **[id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens)** にアクセスします。
      </Step>

      <Step title="API トークンを作成する">
        **Create API token**（または **トークンを作成**）を選択します。Atlassian から再度のサインインや本人確認を求められる場合があります。
      </Step>

      <Step title="トークンに名前を付ける">
        後で迷わずに正しい認証情報を取り消せるように、**Iru Compliance** などのラベルを入力します。
      </Step>

      <Step title="有効期限を設定する">
        最長 **365 日**（執筆時点でのこのトークンタイプにおける Atlassian の上限）の有効期限を選択します。有効期限を短くすると、シークレットが漏洩した場合の影響範囲を抑えられます。
      </Step>

      <Step title="作成してシークレットをコピーする">
        作成を完了し、Atlassian に表示されたときにトークンの値を**一度だけ**コピーします。[**Iru Compliance**](#iru-compliance) タブの Iru の Basic 認証の手順で、Atlassian アカウントのメールアドレスと組み合わせて使用します。
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      先に [**Confluence Cloud**](#confluence-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="Confluence をオンにする">
        **Confluence** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="ウィザードでサブドメインを入力する">
        **Confluence** のサブドメイン（例: `acme`）を入力します。プレビュー URL が `https://acme.atlassian.net/wiki/api/v2` と一致していることを確認してから続行します。
      </Step>

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

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

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

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

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

  <Accordion title="サーバー変数のエラー">
    ディープリンクの有効期限が切れている場合は、ソースをオフにしてからオンに戻してウィザードを更新してください。
  </Accordion>

  <Accordion title="401 Unauthorized">
    メールアドレスは Atlassian ID と一致している必要があります。パスワードフィールドには API トークンを入力する必要があります。
  </Accordion>

  <Accordion title="スペースが表示されない">
    トークンはお客様のスペースの権限を継承します。アカウントにアクセス権を付与するか、別の ID に切り替えてください。
  </Accordion>

  <Accordion title="サブドメインが間違っている">
    ユーザーが使用しているホスト名を再確認してください。入力ミスがあると、すぐにルーティングが失敗します。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="トークンは毎年期限切れになるため、期限前にローテーションしてください。" icon="circle-info">
    トークンは毎年期限切れになります。期限前にローテーションしてください。
  </Card>

  <Card title="Data Center / Server の API は異なり、このコネクタは…" icon="shield">
    Data Center / Server の API は異なります。このコネクタは **Cloud** のみを対象としています。
  </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>