ISVforce Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Editing, Packaging, or Deleting a Connected App

Connected Apps can be created in: Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Connected Apps can be installed in: All Editions

User Permissions Needed
To read: “Customize Application”
To create, update, or delete: “Customize Application” AND either

“Modify All Data” OR “Manage Connected Apps”
To update all fields except Profiles, Permission Sets, and Service Provider SAML Attributes: “Customize Application”
To update Profiles, Permission Sets, and Service Provider SAML Attributes: “Customize Application” AND “Modify All Data”
To uninstall: “Download AppExchange Packages”

After creating a connected app, you can edit, package, or delete it.

The name must be unique for the current connected apps in your organization. You can reuse the name of a deleted connected app if the connected app was created using the Spring ’14 release or later. You cannot reuse the name of a deleted connected app if the connected app was created using an earlier release.

Note

Editing a Connected App

You can update a connected app at any time. From Setup, click Create | Apps. Click a Connected App Name in the list to open the detail page for the app. Click Edit to bring up the edit page where you can make changes. Save your changes by clicking Save.

After you’ve created the connected app, you can go back to the detail page to specify the allowed IP ranges

The IP ranges work with OAuth, not SAML, and specify valid IP addresses for the connected app.

Use the following steps to set the allowed IP range.

  1. From Setup, click Create | Apps.
  2. Click a Connected App Name in the list to open the detail page for the app.
  3. In the Trusted IP Range for OAuth Web server flow section, click New.
  4. Enter a valid IP address in the Start IP Address field and a higher IP address in the End IP Address field.

    You can enter multiple, discontinuous ranges by clicking New to enter each range.

You might want some users to be able to use the connected app from outside of the Trusted IP Range. For example, some users might be allowed to use the connected app while traveling, but other users can not. In this case, set the connected app to Relax IP Restrictions with second factor.  When a user attempts to use the connected app from outside this range, the user is prompted to provide a second factor of authentication, such as a token code. After a successful second factor authentication, the user can use the connected app from outside the Trusted IP Range.

  1. From Setup, click Manage Apps | Connected Apps.
  2. Click Edit next to the connected app name to display the values for the app.
  3. In the IP Relaxation field, select Relax IP Restrictions in the drop-down list.

After you’ve created the connected app, you can also go back to the detail page and specify custom attributes. Use custom attributes to specify SAML metadata or to specify OAuth parameters that are read at OAuth runtime.

  1. From Setup, click Create | Apps.
  2. Click a Connected App Name in the list to open the detail page for the app.
  3. In the Custom Attributes section, click New.

    Each custom attribute must have a unique key and must use fields available from the Insert Field menu. For example, assign a key name, such as country and insert the field $Organization.Country. When using SAML, attributes are sent as SAML attribute statements. When using OAuth, attributes are available as a custom_attributes object in the user’s Identity URL.

Packaging a Connected App

After creating a connected app or a new version of an existing app, package it to make it available to users on other Salesforce organizations. You can add a connected app to a managed package in the same way as, and along with, other components such as custom objects, Visualforce pages, or Apex classes. This makes it easy to distribute a connected app to other Salesforce organizations. As a packageable component, connected apps can also take advantage of all other features of managed packages, such as listing on the AppExchange, push upgrades, post-install Apex scripts, license management, and enhanced subscriber support.

You can only package a connected app from a Developer Edition organization.

Note

Deleting a Connected App

To delete a connected app, click the Connected App Name in the list of apps. Click Delete on the editing page and confirm by clicking Delete again. Even though the app is removed from your list, you cannot reuse the app name.

If you delete a connected app that has been included in a package, the app remains available in the package until you update the package.