Newer Version Available
Connected Apps
A connected app integrates an application with Salesforce using APIs. Connected apps use standard SAML and
OAuth protocols to authenticate, provide single sign-on, and provide tokens for use
with Salesforce
APIs. In addition to standard OAuth
capabilities, connected apps allow Salesforce admins to set various
security policies and have explicit control over who can use the corresponding
apps.
| Available in: both Salesforce Classic and Lightning Experience |
| 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” |
A developer or Salesforce admin defines a connected app for Salesforce by providing the
following information.
- Name, description, logo, and contact information
- A URL where Salesforce can locate the app for authorization or identification
- The authorization protocol: OAuth, SAML, or both
- Optional IP ranges where the connected app might be running
- Optional information about mobile policies that the connected app can enforce
For connected apps that use OAuth service providers, define the OAuth scopes and callback URL for the connected app. In return, Salesforce provides an OAuth Consumer Key and a Consumer Secret for authorizing the connected app. Also define how the OAuth request handles the ID token in a token response.
For connected apps that use SAML service providers, you define the Entity ID, ACS (assertion consumer service) URL, Subject Type, Name ID Format and Issuer for authorizing the connected app. You get this information from the service provider.
The connected app has two
modes of deployment.
- The app is created and used in the same org. This is a typical use case for IT departments.
- The app is created in one org and installed in other orgs. This is a typical use case for ISVs and entities with multiple orgs.
Salesforce admins can install the connected app into
their org and enable SAML authentication. Then they can use profiles, permission sets,
and IP range restrictions to control which users can access the app. Admins can set the
connected app to be exposed as a canvas app
for tighter integration with Salesforce. Admins can also
uninstall the connected app and install a newer
version when a developer updates the app and notifies admins that a new version is
available.
Connected apps can be added to
managed packages, only. Connected apps are not supported for unmanaged packages.