# Integrations

## Organization Integrations

**Organization integrations** work at the organization level, allowing the Platform to connect with various applications and tools for smoother integration with your existing workflows.

Navigate to the [**Organization Setting**](https://docs.probe.splx.ai/settings/platform-settings/organization-settings) and select the **Integrations** from the navigation bar on the left side to start configuring your integrations.

<figure><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2Fvyb0fHhOnHauaomdbkiW%2F2_organization%20integrations.png?alt=media&#x26;token=0556470c-41c9-4f21-a443-847b9f3698c7" alt=""><figcaption><p>Figure 1: Organization Integrations Page</p></figcaption></figure>

## Jira Integration

After clicking "Install" for the Jira integration, you will be redirected to the Atlassian Authorization app. Here, the Platform will request access to your Atlassian account. You will need to select the app you wish to integrate with, grant the necessary access permissions, and accept the privacy policy.

{% hint style="info" %}
All tickets created by the Platform will be displayed as if they were reported by the **user who accepted the integration**.
{% endhint %}

## ServiceNow Integration

To integrate the Platform with ServiceNow, you will need the following information:

* **ServiceNow Instance URL**&#x20;
  * Provide the URL of your ServiceNow instance.
  * E.g., https\://\<your\_instance>.service-now\.com).
* **API Key**&#x20;
  * The API Key required for access to ServiceNow's APIs.
  * To learn how to generate API key, visit the ServiceNow Configure API key - Token-based authentication Page.
* **User ID**&#x20;
  * Your ServiceNow User ID.
  * To view your User ID after generating the API key, click the information button next to the User field on the API key page. For more details, refer to step 2.e. in the previously linked  ServiceNow documentation.

{% hint style="info" %}
All tickets created by the Platform will be displayed as if they were reported by the **user defined in the integration process.** The incident will be posted in the Incident Management Module.
{% endhint %}

<figure><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2FGZrn2yCmLwpWcd2FqNPf%2Fservicenowintegration.png?alt=media&#x26;token=7d8dff47-c459-4ad4-b4d9-1cec87c84a6e" alt=""><figcaption><p>Figure 5: Service Now Installation</p></figcaption></figure>

## Authentication Providers

### Microsoft Entra

To enable Single Sign-On (SSO), integrate the Platform with **Microsoft Entra ID**. This integration allows users to authenticate using their corporate credentials and supports centralized identity management.&#x20;

<figure><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2FMnuhNb4yw8wt5QzqDSn0%2F2_Microsoft_entra.png?alt=media&#x26;token=bfb5c655-06e0-4af3-a4f9-1e86f25b68b9" alt=""><figcaption><p>Figure 6: Entra Integration</p></figcaption></figure>

The integration steps are listed bellow:

Create an App Registration in Azure:

* Sign in to the **Azure portal**, open **Microsoft Entra ID → Manage → App registrations**, and click **+ New registration**.
* Give the application a name that clearly identifies the Platform, and leave the **Redirect URI** field empty for now.
* Click **Register**.
* On the app’s **Overview** page, copy the **Application (client) ID**. You will add this in the Platform shortly.

Generate a Client Secret:

* In the same App registration, navigate to **Certificates & secrets** (under **Manage**).
* Click **+ New client secret**.
* Provide a description and select an expiration period that matches your org’s policy.
* Click **Add**, then copy the **Value** of the new secret, it is shown only once. Store it securely, you’ll paste it into the Platform.

Connect the Platform to Azure Entra ID:

* In the Platform, open **Settings → Organization → Integrations**.
* Locate **Microsoft Entra ID** and click **Setup**.
* Enter the **Client ID** and **Client Secret** you copied from Azure.
* Click **Save**. The Platform will validate the credentials and display a **Redirect URI**.

Add the Redirect URI in Azure:

* Return to the Azure portal and reopen your App registration.
* Go to **Authentication** (under **Manage**).
* Click **Add a platform**, choose **Web**, and paste the **Redirect URI** provided by the Platform.
* Click **Configure**. Verify the URI now appears in the **Redirect URIs** list and click **Save** if prompted.

Confirm the Integration:

* Back in the Platform, attempt to log in with a Microsoft account from your tenant.
* A successful login confirms the integration is complete.