# Manage My Apps & SSO Connections

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2FrHJ4mlrMQpVdpZxi0t2T%2FSSO_My%20Apps.jpg?alt=media&#x26;token=f369a322-5c43-4ef0-9e87-e425d5503f15" alt=""><figcaption></figcaption></figure>

Rechat allows Brokerage Admins to **self-manage My Apps and SSO connections**, enabling secure access to third-party tools using SAML authentication.

This feature positions Rechat as an **Identity Provider (IdP)**—meaning Rechat handles authentication and grants access to connected applications.

{% hint style="info" %}
Only visible to Brokerage Admins
{% endhint %}

Jump to [#create-a-new-app-connection](#create-a-new-app-connection "mention")

Jump to [#add-a-website-link](#add-a-website-link "mention")

## Create a New App Connection

{% stepper %}
{% step %}

### Navigate to Applications

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2FDT6YhglyroyQlXPN4lpR%2FSSO_My%20Apps%20Step%201.jpg?alt=media&#x26;token=d1e51f30-f13b-4b81-84db-0512e0447e75" alt=""><figcaption></figcaption></figure>

1. Team Switch to your Brokerage Brand
2. Click **Settings**
3. Click the **Applications** tab
4. Click **Add New App**
   {% endstep %}

{% step %}

### Choose App Type

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2Fj0IMDIXnM352xCzEVIXc%2FSSO_My%20Apps%20Steps_5.jpg?alt=media&#x26;token=c7fd7bd3-267f-44d3-a60c-6a121fe6331d" alt=""><figcaption></figcaption></figure>

You’ll be prompted to choose the type of app:

* **Single Sign-On (SSO)** → for SAML-based integrations
* **Website Link** → for simple external links

Select **Single Sign-On (SSO)** to continue with SSO setup.
{% endstep %}

{% step %}

### Add Basic App Details

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2F9Us7dOYRaBGOXzMJjiZp%2FSSO_My%20Apps%20Steps_4.jpg?alt=media&#x26;token=32c26917-7baa-42e2-a7bd-0648e7ccd00d" alt=""><figcaption></figcaption></figure>

Enter the required app information:

* **Application Name**
* **App Icon** (PNG, SVG, JPG, or WebP – 64x64 recommended)

Click **Next** to continue
{% endstep %}

{% step %}

### Configure SAML Settings

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2Fr96Lgob4x5laddzuTmDu%2FSSO_My%20Apps%20Steps_3.jpg?alt=media&#x26;token=c3ad3909-90f6-453c-b756-666ce6fb3654" alt=""><figcaption></figcaption></figure>

You’ll now configure the SSO connection using details from your third-party provider.

You have two options:

**Option A: Import Metadata (Recommended)**

* Click **Import Metadata**
* Upload the `.xml` file provided by your application

{% hint style="info" %}
This will automatically populate most fields and reduce setup errors
{% endhint %}

**Option B: Manual Entry**

Fill in the required fields:

* **ACS URL (Assertion Consumer Service URL)**
* **Entity ID**
* **Audience (optional)**
* **Destination (optional)**
* **Recipient (optional)**
  {% endstep %}

{% step %}

### Configure Identity Settings

Select how user identity is passed:

* **Name ID Format**
  * Email (most common)
  * Persistent
  * Transient
  * Unspecified

{% hint style="info" %}
In most cases, **Email** should be used
{% endhint %}
{% endstep %}

{% step %}

### (Optional) Signed Response

Enable **Signed Response** if required by your provider

{% hint style="warning" %}
Only enable this if your third-party application specifically requires it
{% endhint %}
{% endstep %}

{% step %}

### Save the Application

Click **Add App** to complete setup
{% endstep %}
{% endstepper %}

{% hint style="success" %}

## **What Happens Next**

Once saved:

* Your app will appear in the **Applications list**
* You can:
  * Edit details
  * Reorder apps (drag & drop)
  * Access metadata
  * Delete the app
    {% endhint %}

## Add a Website Link

In addition to SSO connections, you can add simple **Website Links** to your My Apps experience—giving agents quick access to commonly used tools or resources.

This is ideal for platforms that **don’t require SSO**, but you still want easily accessible in one place.

#### **How to Add a Website Link**

1. Go to **Settings**
2. Click the **Applications** tab
3. Click **Add New App**
4. Select **Website Link**

<figure><img src="https://1031368632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJZySovZjoLVT1XAonI%2Fuploads%2Fg3silIvjE4wXy0b8eiej%2FSSO_My%20Apps%20Steps_1.jpg?alt=media&#x26;token=53bc41bf-269d-45a8-b265-35a16903c726" alt=""><figcaption></figcaption></figure>

#### **Enter App Details**

Fill in the required fields:

* **Application Name** (what agents will see)
* **Application URL** (destination link)
* **App Icon** (PNG, SVG, JPG, or WebP – 64x64 recommended)

Click **Add App** to save

#### **What Happens Next**

* The link will appear in your **Applications list**
* Agents can click it to instantly access the tool
* You can edit, reorder, or remove it at any time