> 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/editing-a-connected-app.md).

# Editing 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 using OAuth 2.0 tokens. Once connected, your applications will have access to your users, data, attributes, and other resources. You can manage the connection and authentication settings by editing a Connected App. This article describes each setting available for a Connected App.

{% hint style="info" %}
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 %}

## Editing 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%2FrAPIJo1yiQRcj0CzktEd%2FGSEditingAConnectedApp-Edit-01.png?alt=media&amp;token=c019dc92-4466-43a6-9153-ff23259d7810" alt="" width="563"><figcaption></figcaption></figure></div>
3. Click **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%2Ftazq73EAlnrsMKdPVmuc%2FGSEditingAConnectedApp-Edit-02.png?alt=media&amp;token=98c1cecd-3083-463b-b759-42f4933b3116" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Basic Information

<div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F0yEbXhFnSPS4Wf47QjR3%2FGSEditingAConnectedApp-Basic-01.png?alt=media&amp;token=de0691f2-888f-4c6a-9c8a-effd42d29d2a" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="160.33331298828125">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The <strong>Name</strong> field lets you modify the name of the Connected App. This name is specific to your Global Settings tenant, and changing it won't impact your app connections.</td></tr><tr><td><strong>Multi-Tenant Mode</strong></td><td>Enable the <strong>Multi-tenant mode</strong> checkbox to grant access to all users, including those from other tenants. Only enable this if you plan to share your service across multiple tenants.</td></tr><tr><td><strong>Authentication Flows</strong></td><td><p>The <strong>Authentication Flows</strong> dropdown lets you choose which flows your app will support. You can select one or more flows, and each is detailed below.</p><p></p><p><strong><code>Authorization Code</code></strong>  - In this flow, the client app obtains an authorization code following user authentication at the authorization server. The client app then exchanges this code for an access token, enabling access to protected resources.</p><p></p><p><strong><code>Refresh Token</code></strong> - In this flow, upon successful user authentication and authorization, a <strong>Refresh Token</strong> is issued alongside the access token. The <strong>Refresh Token</strong> allows the client app to obtain a new access token after the current one expires, without requiring the user to reauthenticate. This simplifies the token renewal process by eliminating the need for user intervention.</p></td></tr><tr><td><strong>Authorization Scopes</strong></td><td><p>The <strong>Authorization Scopes</strong> dropdown lets you choose which scopes your app will support. You can select one or more scopes, and each is detailed below.</p><p></p><p><strong><code>Offline Access</code></strong> - This is a special OAuth 2.0 permission that allows a client app to receive updated access tokens without requiring direct user interaction.</p></td></tr></tbody></table>
{% endstep %}

{% step %}

### Authorization Policy

<div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fmu6lVx07TR1nhwsXI7ed%2FGSEditingAConnectedApp-Policy-01.png?alt=media&amp;token=cea9e2db-50de-4233-bf31-eff9b78254bf" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="160">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Refresh Token Lifetime</strong></td><td>A <strong>Refresh Token Lifetime</strong> determines how long a refresh token remains valid, enabling clients to acquire new access tokens without needing user re-authentication.</td></tr><tr><td><strong>Access Token Lifetime</strong></td><td>An <strong>Access Token Lifetime</strong> determines how long an access token remains valid, granting clients access to protected resources for that duration before requiring the user to re-authenticate.</td></tr></tbody></table>
{% endstep %}

{% step %}

### Authorized URLs

<div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FQHSp1ACNPolsOxuPdtj2%2FGSEditingAConnectedApp-Urls-01.png?alt=media&amp;token=5be6806c-b460-4d41-a920-17f055adc705" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="159.6666259765625">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Allowed Callback URLs</strong></td><td><p>You can add URLs to the list of <strong>Allowed Callback URLs</strong> that the authorization server redirects the user to after successful authentication and authorization. </p><p>Example: <code>https://backup.com/api/v1/oauth/callback</code></p></td></tr><tr><td><strong>Allowed Sign-Out URLs</strong></td><td><p>You can add URLs to the list of <strong>Allowed Sign-Out URLs</strong> that the user can be redirected to after successfully signing out of an app or identity provider.</p><p>Example: <code>https://backup.com/api/v1/oauth/login</code></p></td></tr></tbody></table>
{% endstep %}

{% step %}

### Save Changes

1. Click **Save.**&#x20;

   <div align="left"><figure><img src="https://579543750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FUohUiQEr5IqypGQqrQYr%2FGSEditingAConnectedApp-Save-01.png?alt=media&amp;token=00b7bd64-190a-4e82-90cc-f4638946ac60" alt="" width="563"><figcaption></figcaption></figure></div>
2. Changes to the Connected App are applied immediately.
   {% 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/editing-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.
