Newer Version Available

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

NetworkAuthApiSettings

Represents the settings that control enablement, access, and security for the Headless Registration Flow, Headless Forgot Password Flow, Headless Passwordless Login Flow, and their associated APIs. This object is available in API version 58.0 and later.

Supported Calls

create(), delete(), describeSObjects(), query(), retrieve(), update(), upsert()

Special Access Rules

Headless identity features are set up via Experience Cloud sites. You must have an Experience Cloud site to access Headless Identity APIs and store users, even if users never interact with the site directly.

Fields

Field Details
CustomOtpDeliveryHandlerId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This field is a relationship field.
The ID of a custom one-time password (OTP) delivery handler that implements the Auth.CustomOneTimePasswordDeliveryHandler interface.
DoesForgotPasswordRequireAuth
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether authentication is required to access Headless Forgot Password API when a password reset is requested. If true, an access token issued to an internal integration user in your initial POST request to the /services/auth/headless/forgot_password endpoint is required. The access token must include the forgot_password scope.
The default value is false.
DoesPasswordLoginRequireAuth
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether reCAPTCHA is required for headless username-password login that uses the OAuth 2.0 for First-Party Applications draft protocol.
DoesPwdlessLoginRequireAuth
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether authentication is required to access Headless Passwordless Login API when user information is submitted to Salesforce. If true, an access token issued to an internal integration user is required in your initial POST request to the /services/auth/headless/init/passwordless/login endpoint. The access token must include the pwdless_login_api scope.
The default value is false. This field is available in API version 59.0 and later.
DoesRegistrationRequireAuth
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether authentication is required to access Headless Registration API when user registration information is submitted to Salesforce. If true, an access token issued to an internal integration user in your initial POST request to the /services/auth/headless/init/registration endpoint is required. The access token must include the user_registration_api scope.
The default value is false.
HeadlessDiscoveryExecutionUserId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This field is a relationship field.
The ID of an integration user account to run a headless user discovery Apex handler.
Relationship Name
HeadlessDiscoveryExecutionUser
Refers To
User
HeadlessDiscoveryHandlerId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This field is a relationship field.
The ID of an Apex class that implements the Auth.HeadlessUserDiscoveryHandler interface.
Relationship Name
HeadlessDiscoveryHandler
Refers To
ApexClass
isFirstPartyAppsAllowed
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether the Experience Cloud site can use headless identity flows that use the OAuth 2.0 for First-Party Applications draft protocol.
IsForgotPwdAllowed
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether the Headless Forgot Password Flow is enabled.
The default value is false.
IsForgotPwdEmailTemplateAllowlistingEnabled
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Descriptions
Determines whether email template allowlisting is enabled for the Headless Registration Flow, Headless Passwordless Login Flow, and Headless Forgot Password Flow. If true, the initial request to the headless API must include an emailtemplate parameter that contains only allowlisted email templates.
The default value is false.
IsHeadlessUserRegistrationAllowed
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether the Headless Registration Flow is enabled.
The default value is false.
IsPwdlessLoginAllowed
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether the Headless Passwordless Login Flow is enabled (true) or not (false).
The flow is disabled by default. This field is available in API version 59.0 and later.
IsRecaptchaRequiredForgotPwd
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether a reCAPTCHA token is required to access Headless Forgot Password API when a password reset is requested. If true, a reCAPTCHA token is required in your initial POST request to the /services/auth/headless/forgot_password endpoint.
The default value is false.
IsRecaptchaRequiredPwdlessLogin
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether a reCAPTCHA token is required to access Headless Passwordless Login API when user information is submitted to Salesforce. If true, a reCAPTCHA token is required in your initial POST request to the /services/auth/headless/init/passwordless/login endpoint.
By default, a reCAPTCHA token isn’t required (false). This field is available in API version 59.0 and later.
IsRecaptchaRequiredRgstr
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether a reCAPTCHA token is required to access Headless Registration API when user registration information is submitted to Salesforce. If true, a reCAPTCHA token is required in your initial POST request to the /services/auth/headless/init/registration endpoint.
The default value is false.
IsUniversalClientRgstrAllowed
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether self-registration and passwordless login via Universal Registration API are enabled.
The default value is false.
IsUserDisambiguationAllowedForgotPwd
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether the Headless Forgot Password Flow uses the headless user discovery Apex handler that's specified in the HeadlessDiscoveryHandlerId field. The handler enables users to reset their password with an identifier other than their username, such as an email address, phone number, or order number.
The default value is false.
IsUserDisambiguationAllowedUsernamePwd
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Determines whether headless login flows use the headless user discovery Apex handler that's specified in the HeadlessDiscoveryHandlerId field. The handler enables users to log in with an identifier other than their username, such as an email address, phone number, or order number. This field applies to the Authorization Code and Credentials Flow and the OAuth 2.0 for First-Party Applications login flow.
The default value is false.
MaxPasswordResetAttempts
Type
int
Properties
Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
Description
The maximum number of password reset attempts you allow for the Headless Forgot Password Flow before the user must request a new one-time password (OTP).
NetworkId
Type
reference
Properties
Create, Filter, Group, Sort
Description
The ID of your Experience Cloud site. This ID is unique within your org.
This field is a relationship field.
Relationship Name
Network
Relationship Type
Lookup
Refers To
Network
RecaptchaScoreThreshold
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
The lowest reCAPTCHA score that is accepted before rejecting a request to access Headless Identity APIs. This value must be between 0.5 and 1. Scores closer to 0.5 are more likely to be bots, while scores closer to 1 are more likely to be valid users.
You must set a score threshold if DoesForgotPasswordRequireAuth or DoesRegistrationRequireAuth fields are set to true. reCAPTCHA settings apply to both the Headless Registration Flow and the Headless Forgot Password Flow.
Google issues a reCAPTCHA score only for reCAPTCHA v3 implementations. If you implement reCAPTCHA v2, this field doesn’t apply.
RecaptchaSecretKey
Type
encryptedstring
Properties
Create, Nillable, Update
Description
The reCAPTCHA secret key from your API key pair. You get the API key pair from Google when you set up reCAPTCHA. The secret key helps your app securely communicate with Google.
You must enter a secret key if DoesForgotPasswordRequireAuth or DoesRegistrationRequireAuth are set to true. reCAPTCHA settings apply to both the Headless Registration Flow and the Headless Forgot Password Flow.
RegistrationExecutionUserId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The ID of the user who runs your headless registration Apex handler.
This field is a relationship field.
Relationship Name
RegistrationExecutionUser
Relationship Type
Lookup
Refers To
User
RegistrationHandlerId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The ID of your headless registration Apex handler.
This field is a relationship field.
Relationship Name
RegistrationHandler
Relationship Type
Lookup
Refers To
ApexClass
RegistrationUserDefaultProfileId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The ID of the default profile that gets assigned to new users when they register.
This field is a relationship field.
Relationship Name
RegistrationUserDefaultProfile
Relationship Type
Lookup
Refers To
Profile