# Manage My Apps & SSO Connections

<figure><img src="/files/zkapowQT2ympdF6im2IH" 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="/files/6gaakPmkCxhr3Q6UDPhG" 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="/files/ySKCZvqiJdFi3vhJhN1Y" 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="/files/BZXIXOf5NSHcy2NFHls2" 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="/files/ZOqMKWG2mUXm91G1stYz" 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="/files/l3hSN9CI6qiJM8MbuyOX" 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


---

# 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://help.rechat.com/appendix/brokerage-set-up/manage-my-apps-and-sso-connections.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.