Manage a Custom Passport

Manage Custom Passports in Appspace to update OAuth credentials, control permissions, export configurations, or remove integrations that are no longer needed. The passport edit page provides centralized controls for the full lifecycle of an existing Custom Passport.

Prerequisites

Before starting, ensure the following are in place.

• The Appspace user account has the Account Owner, Platform Administrator, or Location Publisher role.
• The Custom Passport already exists in Appspace.

View Custom Passport Details

Follow the instructions below to view the OAuth configuration of an existing Custom Passport.

1. Log in to the Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click the Passports tab.
3. Click the name of the Custom Passport to open the edit page.
4. Click the Account Settings tab to view the authentication type, Client ID, authorization URL, token URL, and scopes.

   Note

   Sensitive values such as the Client Secret are hidden by default on the Account Settings tab. Click the eye icon to reveal or conceal the value.

Update Custom Passport Settings

Follow the instructions below to update the name, description, or OAuth credentials of an existing Custom Passport.

1. Open the Custom Passport edit page.
2. Click the Account Settings tab.
3. Edit the passport name, display name, description, or OAuth credentials.
4. Click Save.

Manage Custom Passport Permissions

Follow the instructions below to control which users or groups can use a Custom Passport.

1. Open the Custom Passport edit page.
2. Click the Permissions tab.
3. Add or remove users and groups that can use this passport.
4. Click Save.

Export a Custom Passport

Follow the instructions below to export a Custom Passport configuration as a JSON file. Exported files can be re-imported into another Appspace environment using Import a Custom Passport from JSON.

1. Log in to the Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click the Passports tab.
3. Locate the Custom Passport in the list.
4. Click the ellipsis (⋯) menu next to the passport, and select Export Passport. A JSON file named <passport-name>-passport.json downloads to the local device.

Delete a Custom Passport

Follow the instructions below to permanently remove a Custom Passport from Appspace.

1. Log in to the Appspace console.
2. Click Integrations from the ☰ Appspace menu, and click the Passports tab.
3. Locate the Custom Passport in the list.
4. Click the ellipsis (⋯) menu next to the passport, and select Delete.
5. Confirm the deletion.

Related Articles

• Create a Custom Passport
• Import a Custom Passport from JSON
• Custom Passport Configuration Reference