> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cymph.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage integrations
## How to create an integration
1. Go to the workspace you want to add an integration for
* From Workspace menu, select the workspace from the navigator
2. Go to the **Integrations** tab.
* Select the Manage from the navigation menu and the **Integrations**
3. Click on **New Integration** from the top right corner
4. Select your integration type. The following types are available:
* Cortex XSOAR
* n8n
* Microsoft Sentinel
* Wazuh
* StackStorm
* Confluence
* JIRA
* ServiceNow
* Github
* GitLab
* GitBook
* SharePoint
* DFIR-IRIS
* Azure
5. Fill in the details for your integration. In the screenshot below, you see an example for n8n. Common to all integration setyps is the option to share the instance with the rest of your organisation.
6. Before adding the integration, you can test the settings via **Test Connection**
7. Click on **Add Integration** to add your integration
* Depending on your plan, you might see different list of available integration types. The n8n, JIRA, StackStorm and SOARCA integration is always available for all plans.
* Integrations should have unique name per type.
* When testing an integration, the backend will give up testing after 5 seconds of trying to connect to the integration instance
* Depending on the integration type, you might see different options for the integration
### Adding a Cortex XSOAR integration
When you add an integration with Cortex XSOAR, you need:
* The URL of the instance
* An API key from your instance. In order to generate an API key, you need to follow the instructions [here](https://docs-cortex.paloaltonetworks.com/r/Cortex-XSOAR-6-API/Cortex-XSOAR-6-overview)
### Adding an n8n integration
When you add an integration with n8n, you need:
* The URL of the instance
* An API key from n8n. In order to generate an n8n API key, you need to follow the instructions [here](https://docs.n8n.io/api/authentication/)
### Adding a ServiceNow integration
When you add an integration with ServiceNow, you need:
* The URL of the instance
* An API key from ServiceNow. In order to generate an API key, you need to follow the instructions [here](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/authentication/task/configure-api-key.html)
### Adding a StackStorm integration
The integration with StackStorm requires:
* The URL of the instance
* An API key. All API key management is currently available via the StackStorm CLI or API. To create an API key:
`st2 apikey create -k -m '{"used_by": "my integration"}'`
You can read more detailed documentation [here](https://docs.stackstorm.com/authentication.html)
### Adding a JIRA or Confluence integration
The integration with JIRA or Confluence requires:
* The URL of your instance, e.g. [https://mydomain.atlassian.net](https://mydomain.atlassian.net)
* The e-mail address of the user, e.g. [myuser@example.com](mailto:myuser@example.com)
* An API token for your JIRA account. You can follow the instructions provided [here](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) to generate a token. The token must be created for the JIRA app and have the appropriate scopes for reading, updating and deleting issues.
For Confluence API tokens, the following scopes are required:\
`read:page:confluence`\
`read:space:confluence`\
or if you are using classic scopes:\
`read:confluence-content.all`\
`read:confluence-space.summary`
For JIRA, the following scopes are required for your API token:\
`read:project:jira`\
`read:issue-type:jira`\
`read:field:jira`\
`write:issue:jira`\
or in case you are using classic scopes:\
`read:jira-work`\
`write:jira-work`
## How to update an integration
1. Go to the **Integrations** tab of the workspace.
2. Edit the integration.
* Select the **Edit** icon next to the integration you want to edit.
3. Edit the integration details.
* Provide a new name for the integration (optional).
* Modify the URL of the integration endpoint (optional).
4. Test the integration (optional).
* Click the **Test Connection** button.
* If the integration is valid, a message will appear that the integration is tested successfully. Differently, a message containing the test error will appear.
5. Update the integration.
* Click the **Update Integration** button.
6. The list of integrations will be updated automatically to reflect the new changes.
## How to delete an integration
1. Go to the **Integrations** tab of the workspace.
2. Delete the integration.
* Select the **Delete** icon next to the integration you want to delete.
* Confirm the deletion by clicking the **Delete** button on the confirmation dialog that appears.
3. The list of integrations will be updated automatically to reflect the new changes.
