Represents an external authentication (auth)
identity provider. An external auth identity provider links to an external credential
and obtains OAuth tokens for outbound callouts to external systems.
Parent Type
This type extends the
Metadata metadata type and inherits its
fullName field.
File Suffix and Directory Location
ExternalAuthIdentityProvider components have the suffix
.externalAuthIdentityProvider and are stored in the
externalAuthIdentityProviders folder.
Version
ExternalAuthIdentityProvider components are available in API version 62.0 and later.
Special Access Rules
Only users with the Customize Application permission or the Manage Named Credentials
permission can access this type.
Fields
| authenticationFlow |
- Field Type
- IdentityProviderAuthFlow (enumeration of type
string)
- Description
-
Required.
Authentication flow to get tokens to call protected APIs. Values are:
- AuthorizationCode
- ClientCredentials
- SalesforceDefined
|
| authenticationProtocol |
- Field Type
- IdentityProviderAuthProtocol (enumeration of type
string)
- Description
-
Required.
The authentication protocol that’s required to access the external system. Values
are:
|
| description |
- Field Type
- string
- Description
- A meaningful description of the external auth identity provider.
|
| externalAuthIdentityProviderParameters |
- Field Type
- ExternalAuthIdentityProviderParameter[]
- Description
- One or more sets of parameters that further configure the external auth identity
provider.
|
| label |
- Field Type
- string
- Description
-
Required.
Name of the external auth identity provider.
|
ExternalAuthIdentityProviderParameter
Represents the parameters that configure an external auth identity provider.
These parameters are used internally to provide a flexible architecture and are
exposed here for packaging reasons.
| description |
- Field Type
- string
- Description
- A human-readable description of this external auth
identity provider parameter.
|
| parameterName |
- Field Type
- string
- Description
-
Required.
The name of the external auth identity provider
parameter.
|
| parameterType |
- Field Type
- ExtlIdentityProviderParmType (enumeration of type
string)
- Description
-
Required.
The type of external auth identity provider
parameter. The value of this field drives the
behavior of the parameter. Values are:
- AuthorizeRequestQueryParameter
- AuthorizeUrl
- ClientAuthentication
- CreatedByNamespace
- IdentityProviderOptions
- ManagedByComponent
- ManagedByFeature
- RefreshRequestBodyParameter
- RefreshRequestHttpHeader
- RefreshRequestQueryParameter
- StandardExternalIdentityProvider
- TokenRequestBodyParameter
- TokenRequestHttpHeader
- TokenRequestQueryParameter
- TokenUrl
- UserInfoUrl
|
| parameterValue |
- Field Type
- string
- Description
- If the parameterType field
describes a literal value, then this field stores
the literal value.
|
| sequenceNumber |
- Field Type
- int
- Description
- Specifies the order of parameters to apply when an
external auth identity provider has more than one
parameter. Priority is from lower to higher numbers (for
example, 1 is the highest priority).
|
Declarative Metadata Sample Definition
The following is an example of an ExternalAuthIdentityProvider component.
The following is an example package.xml that
references the previous definition.