OAuth 2.0 for First-Party Applications: Configure an External Client App for Headless
Identity Flows
To develop headless identity flows that use the OAuth 2.0 for First-Party Applications
draft standard, configure an external client app. For these flows, you must configure your
external client app via Metadata API. Use these steps to configure an app for headless
username-password login, passwordless login, and registration.
Required Editions
Available in: both Salesforce Classic and
Lightning Experience
Available in: Enterprise, Unlimited, and Developer
Editions
User Permissions Needed
To configure both settings and policies as an external client app developer:
Create, edit, and delete External Client Apps
To manage external client app policies as an external client app admin:
View all External Client Apps, view their settings, and edit their policies
The OAuth plugin must also be enabled for your external client app. For more information, see
these resources.
Set the isConsumerSecretOptional field to false. These flows are supported only for private clients,
which can keep the consumer secret secure in a private client backend.
Set isPkceRequired to true. If
you don't use PKCE, the security features of this flow don't work properly.
Set the value for permittedUsersPolicyType to AdminApprovedPreAuthorized.
Note Saving this change causes all users currently using the app to lose access.
To define which users are admin-approved, use permission sets. Enter a list of permission set IDs for the
commaSeparatedPermissionSet field.
Your app can now use the OAuth 2.0 for First-Party Applications flows for headless
username-password login, passwordless login, and registration.
Did this article solve your issue?
Let us know so we can improve!
Loading
Salesforce Help | Article
Cookie Consent Manager
General Information
Required Cookies
Functional Cookies
Advertising Cookies
General Information
We use three kinds of cookies on our websites: required, functional, and advertising. You can choose whether functional and advertising cookies apply. Click on the different cookie categories to find out more about each category and to change the default settings.
Privacy Statement
Required Cookies
Always Active
Required cookies are necessary for basic website functionality. Some examples include: session cookies needed to transmit the website, authentication cookies, and security cookies.
Functional Cookies
Functional cookies enhance functions, performance, and services on the website. Some examples include: cookies used to analyze site traffic, cookies used for market research, and cookies used to display advertising that is not directed to a particular individual.
Advertising Cookies
Advertising cookies track activity across websites in order to understand a viewer’s interests, and direct them specific marketing. Some examples include: cookies used for remarketing, or interest-based advertising.