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

> Connect Confluence Cloud to Iru Compliance with your Atlassian subdomain and an API token to collect spaces, page hierarchy, and access-permission evidence.

### About Confluence Cloud

The **Confluence Cloud** connector gathers **space**, **page**, and **membership** data you need for access-review and change-management evidence. The wizard is two parts: first you provide your **`*.atlassian.net`** subdomain so Iru can reach `https://YOUR_SUBDOMAIN.atlassian.net/wiki/api/v2`, then you supply **HTTP Basic** credentials built from your **Atlassian email** and **API token**.

### How It Works

REST calls use Basic authentication:

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

Passwords are not accepted - only API tokens.

| Detail             | Value                                                     |
| ------------------ | --------------------------------------------------------- |
| **Category**       | Knowledge management                                      |
| **Authentication** | Basic auth (email + Atlassian API token)                  |
| **Scope**          | **Confluence Cloud** REST API v2 (not Data Center/Server) |

Documentation: [Basic auth for Confluence Cloud](https://developer.atlassian.com/cloud/confluence/basic-auth-for-rest-apis/), [REST v2 intro](https://developer.atlassian.com/cloud/confluence/rest/v2/intro/), [API tokens](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).

### Prerequisites

* Access to the **spaces** you want evidence from.
* Your **subdomain** - the label before **`.atlassian.net`** (for example `acme` when users visit `https://acme.atlassian.net/wiki`).

### Connect Confluence Cloud to Iru

<Tabs>
  <Tab title="Confluence Cloud">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Open Atlassian API tokens">
        In a browser, go to **[id.atlassian.com/manage/api-tokens](https://id.atlassian.com/manage/api-tokens)** while signed in to the **same Atlassian account** you use for Confluence Cloud.
      </Step>

      <Step title="Create an API token">
        Select **Create API token** (or **Create token**). Atlassian may ask you to sign in again or confirm your identity.
      </Step>

      <Step title="Name the token">
        Enter a label such as **Iru Compliance** so you can revoke the right credential later without guessing.
      </Step>

      <Step title="Set expiry">
        Choose an expiry up to **365 days** (Atlassian’s maximum for this token type at the time of writing). Shorter expiries reduce blast radius if a secret leaks.
      </Step>

      <Step title="Create and copy the secret">
        Finish creation and copy the token value **once** when Atlassian shows it. You will combine it with your Atlassian account email in Iru’s Basic auth step on the [**Iru Compliance**](#iru-compliance) tab.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Confluence Cloud**](#confluence-cloud) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Confluence">
        Find **Confluence** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Enter subdomain in the wizard">
        Enter your **Confluence** subdomain (for example `acme`). Confirm the preview URL matches `https://acme.atlassian.net/wiki/api/v2`, then continue.
      </Step>

      <Step title="Enter Basic authentication">
        When the wizard asks for Basic authentication, provide your **Atlassian email** and **API token**.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Credentials**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Confluence** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="Server variable errors">
    Refresh the wizard by toggling the source off/on if the deep link expired.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Email must match your Atlassian ID; password field must contain an API token.
  </Accordion>

  <Accordion title="Missing spaces">
    Token inherits your space permissions - grant the account access or switch identities.
  </Accordion>

  <Accordion title="Wrong subdomain">
    Double-check the hostname your users rely on - typos break routing immediately.
  </Accordion>
</AccordionGroup>

### Considerations

<CardGroup cols={2}>
  <Card title="Tokens expire yearly: rotate ahead of deadlines." icon="circle-info">
    Tokens expire yearly - rotate ahead of deadlines.
  </Card>

  <Card title="Data Center / Server APIs differ: this connector…" icon="shield">
    Data Center / Server APIs differ - this connector targets **Cloud** only.
  </Card>
</CardGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>