> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.10/configure-cortex-xsoar/integrations/configure-integrations.md). # Configure integrations Integrations are mechanisms through which Cortex XSOAR connects and communicates with other products. These integrations can be executed through REST APIs, webhooks, and other techniques. Integrations enable you to orchestrate and automate SOC operations. Integrations can be one-way or two-way. Two-way integrations allow both systems to interact directly, making it easier to manage security operations across multiple tools. #### Integrations installed from a content pack Integrations are included in content packs which you download and install from Marketplace. After you download and install a content pack that includes an integration, you need to configure the integration by adding an instance. You can have multiple instances of an integration, for example, to connect to different environments. Additionally, if you are an MSSP and have multiple tenants, you could configure a separate instance for each tenant. Cortex XSOAR comes out-of-the-box with several integrations to help you onboard, such as: * Mail Sender Sends email notifications to users. By default, this integration is configured to send emails. You can change the main sender by configuring a different mail sender, such as Gmail. For more information, see [Configure user notifications in Cortex XSOAR](/cortex-xsoar-8-on-prem/8.10/onboard-cortex-xsoar/onboard-and-configure-cortex-xsoar/post-deployment/user-communication.md#configure-user-notifications-in-cortex-xsoar). * Generic Export Indicators Service Provides an endpoint with a list of indicators as a service for the system indicators. For more information about how to set up the integration, see [Export indicators using the Generic Export Indicators Integration](/cortex-xsoar-8-on-prem/8.10/investigate-and-respond-to-threats/threat-intel-management/export-indicators.md#export-indicators-using-the-generic-export-indicators-integration). * Palo Alto Networks WildFire Reports Generates a Palo Alto Networks WildFire PDF report. For more information, see [Palo Alto Networks WildFire Reports](https://xsoar.pan.dev/docs/reference/integrations/wild-fire-reports). * Rasterize Converts URLs, PDF files, and emails to an image file or PDF file. For more information, see [Rasterize](https://xsoar.pan.dev/docs/reference/integrations/rasterize). #### Create an integration You can create an integration, by adding parameters, commands, arguments, and outputs as well as writing the necessary integration code. You should have a working Cortex XSOAR tenant and programming experience with Python. To create an integration, on the **Instances** page, click **BYOI**. ![byoi-8.png](/files/rskohWkJG4ZkfBfNN81r) The Cortex XSOAR IDE and the **HelloWorld** integration template are loaded by default. For more information about how to create an integration including an example, see [Create an Integration](https://xsoar.pan.dev/docs/tutorials/tut-integration-ui). #### Configure an integration On the **Instance** integration page, after you have either downloaded the integration or created an integration, you can do the following: | Option | Description | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Add instance |

Configure an integration instance to connect and communicate with other products. For more information, see Add an integration instance.

After configuring the instance, you can also enable/disable the integration instance, copy the instance, and view the integration fetch history.

| | View Integration's source | View the integration settings and source code. | | Edit integration's source |

Edit the integration settings and source code. For more information about editing the integration's source code, see Create an Integration.

Note

If the integration was installed from a content pack you need to duplicate the integration before editing.

| | Duplicate integration | If you want to change the source code, and settings, or download the integration, you need to duplicate the integration. | | Delete | Although you can't delete an integration installed from a content pack (unless a duplicate), you can delete an integration instance. | | Download the integration |

Download the integration in YAML format. You can also upload an integration.

Note

If the integration was installed from a content pack you need to duplicate the integration before downloading.

| | Version History | If the integration is a duplicate or you create your integration, you can see the changes in the integration. | | Contribute to Marketplace | You can send the integration to Palo Alto Networks for review and for it to be added to Marketplace. For more information, see [Content pack contributions](/cortex-xsoar-8-on-prem/8.10/configure-cortex-xsoar/marketplace/content-pack-contributions.md). | You can view all the integration changes (the last 100 changes) by clicking the **Version History** button. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.10/configure-cortex-xsoar/integrations/configure-integrations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.