> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/security/connected-apps/managing-a-connected-app.md).

# Managing a Connected App

{% hint style="success" %}

#### Required User Credentials

\[**Flosum User**] - **SystemAdministrator** Role
{% endhint %}

## ![](https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d)Overview

A Connected App lets you link your applications to Flosum Cloud Apps. After adding a Connected App to your account, you can manage it through the following actions:

* [#disable-connected-app](#disable-connected-app "mention")
* [#enable-connected-app](#enable-connected-app "mention")
* [#regenerate-secret-key](#regenerate-secret-key "mention")
* [#delete-connected-app](#delete-connected-app "mention")

{% hint style="info" %}
For details about editing a Connected App, see the following article:

* [Editing a Connected App](/global-settings/security/connected-apps/editing-a-connected-app.md)

For specific instructions on using a Connected App to connect to Flosum's Apps in Salesforce, see the following article.

* [Enable Access to Flosum Backup & Archive Data](/global-settings/security/connected-apps/enable-access-to-flosum-backup-and-archive-data.md)
  {% endhint %}

## Managing A Connected App

{% stepper %}
{% step %}

### Access Global Settings

1. From any **Flosum Cloud App**, click the **App Switcher** icon at the top of the left sidebar menu.

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fgh5FcQCnErKAjJ7isiuB%2FGS-Access-01.png?alt=media&amp;token=ddf01506-f133-4e49-825a-76a2a237e3a8" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click **Global Settings**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fx5vntzgpLuT50fMTzwT9%2FGS-Access-02.png?alt=media&amp;token=f67a125f-5087-47c2-9bc6-9393c3d2b7a5" alt="" width="563"><figcaption></figcaption></figure></div>
3. The **Global Settings** app will open in a new tab.

{% hint style="info" %}
Global Settings can also be accessed by logging in directly via the Flosum Cloud Apps Login URL. See the following article for login instructions.

* [Log In To Global Settings](/global-settings/getting-started/log-in-to-global-settings.md)
  {% endhint %}
  {% endstep %}

{% step %}

### Select a Connected App

1. Click **Connected Apps** from the sidebar menu.
2. Click the **Name** of the Connected App to edit.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FS6R1e8WwNVm2UU9lD8Dz%2FGSManagingAConnectedApp-Select-01.png?alt=media&amp;token=21978568-aaee-48d4-ba0e-9b2cba1e77cb" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Disable Connected App

Disabling the Connected App means your applications will be unable to connect to Flosum Cloud Apps through this connection.

1. Click the **Actions** dropdown menu.
2. Click **Disable**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F0ukotdyuuEyFD1yi0NGO%2FGSManagingAConnectedApp-Disable-01.png?alt=media&amp;token=f90d13e6-ac41-40be-adb4-c9e154b0887d" alt="" width="563"><figcaption></figcaption></figure></div>
3. Click **Confirm** in the Disable Connected App dialog box.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Frry4ctodJl2iLhjbj53j%2FGSManagingAConnectedApp-Disable-02.png?alt=media&amp;token=0dba512f-99ff-4400-b033-3cc7c48b942f" alt="" width="375"><figcaption></figcaption></figure></div>
4. The Connected App **Status** is updated to **Disabled**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F32pc3Z3YNOkKBuxVUyGJ%2FGSManagingAConnectedApp-Disable-03.png?alt=media&amp;token=e9994b0c-2b73-4cca-8357-8d67e56eabbd" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Enable Connected App

If a Connected App is disabled, you can re-enable it to allow access to Flosum Cloud Apps through the Connected App.

1. Click the **Actions** dropdown menu.
2. Click **Enable**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FsJmjGsHvXOTEIye14ABB%2FGSManagingAConnectedApp-Enable-01.png?alt=media&amp;token=e1c04587-25fd-48cd-aed6-f1eab01646ed" alt="" width="563"><figcaption></figcaption></figure></div>
3. Click **Confirm** in the Enable Connected App dialog box.&#x20;
4. The Connected App **Status** is updated to **Active**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fgh6USYC3Hu27aEnJhAO3%2FGSManagingAConnectedApp-Enable-03.png?alt=media&amp;token=c0c38614-f1d7-4992-ae06-a08ec7892168" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Regenerate Secret Key

You can create a new Secret Key for the Connected App.

{% hint style="warning" %}
If you create a new Secret Key, all clients connected to this app will be disconnected, and all authorizations will be removed. The clients will need to have the new Secret Key before they can connect again.
{% endhint %}

1. Click the **Actions** dropdown menu.
2. Click **Regenerate Secret**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F0yVSuWhHRFWC5u7nojtT%2FGSManagingAConnectedApp-Secret-01.png?alt=media&amp;token=e82ecdc7-bf86-4607-af28-6ac49e0d1b95" alt="" width="563"><figcaption></figcaption></figure></div>
3. Click **Confirm** in the Regenerate Secret dialog box.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FydQtktKbBNW5kCREX5M5%2FGSManagingAConnectedApp-Secret-02.png?alt=media&amp;token=e1061854-4d12-447d-bafc-20e9daf94db4" alt="" width="375"><figcaption></figcaption></figure></div>
4. The **Client secret** has the new Secret Key.

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSr0ORrc0Aw8HM0p7qnU6%2FGSManagingAConnectedApp-Secret-03.png?alt=media&amp;token=db791f94-1b17-4ccc-8f22-93c37c9f1ad5" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Delete Connected App

When you delete a Connected App, your applications will lose access to Flosum Cloud Apps via this connection. To restore connectivity, you must create a new Connected App.

1. Click the **Actions** dropdown menu.
2. Click **Delete**.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FAnjsetmHsLPSzFhyTCs9%2FGSManagingAConnectedApp-Delete-01.png?alt=media&amp;token=02f7e02e-ad2c-4450-802f-075ef320a00d" alt="" width="563"><figcaption></figcaption></figure></div>
3. Click **Confirm** in the Delete Connected App dialog box.&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FkchmJo2FIzQBxec4MkMd%2FGSManagingAConnectedApp-Delete-02.png?alt=media&amp;token=5f8d731c-afef-4307-a8b0-e0cbd1b69448" alt="" width="375"><figcaption></figcaption></figure></div>
4. The Connected App will be removed from the list.
   {% endstep %}
   {% endstepper %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/global-settings/security/connected-apps/managing-a-connected-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
