# Confluence

## Introduction 

Confluence is a collaborative workspace that enables teams to create, share, and organize content in one centralized location. It can be integrated with a variety of other tools to streamline workflows and improve efficiency. This guide will walk you through the steps required to integrate Confluence with Perimeters.

## Available Features

* Identity Rules
* User Inventory
* Shadow Application Rules
* Shadow Application Inventory

## Prerequisites

* A Confluence account user with Org Admin, Confluence Admin, and Confluence User role, and all internal user domains verified in Atlassian Guard

<details>

<summary><strong>Follow these steps to generate the API Token:</strong> </summary>

1. Login to Atlassian account
2. Go to <https://id.atlassian.com/manage-profile/security/api-tokens>
3. Click "Create API token"&#x20;
4. Add a label and click create&#x20;
5. Click "Copy" to copy the generated API Token&#x20;

</details>

<details>

<summary><strong>Follow these steps to generate the API Key:</strong> </summary>

1. Login to Atlassian Admin portal using Admin Account
2. Go to [Atlassian Account](https://admin.atlassian.com/) -> **Settings -> API Keys** tab.
3. Click "Create API key" -> Select "API Key without Scopes".
4. Add a label and update the expiry date. Click Create.
5. Click "Copy" to copy the generated API key.

</details>

## Onboarding Confluence in your Perimeters account

1. Go to "Integrations" -> Select "Confluence" -> Click "+ Add" -> Click "+ Start Integration".
2. **"Namespace" -**\
   Fill in the domain name for your Confluence instance. For example, if your Confluence domain name is "perimeters.atlassian.net" you would enter "perimeters" in this field.
3. **"Email" -**\
   Provide the Email address of the user used to create the API token.
4. **“API Token” -**\
   Copy the API token you previously created from your Confluence Profile page and paste it here.
5. **“API Key” -**\
   Copy the API key you previously created from your Atlassian Admin page and paste it here.
6. Click **"Finish"** to complete the onboarding process.

Once you have completed these steps, Confluence should be successfully integrated with your Perimeters account.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/confluence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.