createSamlConnection()
Creates a new SamlConnection.
function createSamlConnection(params: CreateSamlConnectionParams): Promise<SamlConnection>- Name
name- Type
string- Description
The name to use as a label for this SAML Connection.
- Name
provider- Type
'saml_custom' | 'saml_okta' | 'saml_google' | 'saml_microsoft'- Description
The Identity Provider (IdP) provider of the connection.
- Name
domain- Type
string- Description
The domain of your organization. Sign in flows using an email with this domain will use this SAML Connection. For example:
'clerk.dev'
- Name
organizationId?- Type
string- Description
The ID of the organization to which users of this SAML Connection will be added
- Name
idpEntityId?- Type
string- Description
The Entity ID as provided by the Identity Provider (IdP).
- Name
idpSsoUrl?- Type
string- Description
The Single-Sign On URL as provided by the Identity Provider (IdP).
- Name
idpCertificate?- Type
string- Description
The X.509 certificate as provided by the Identity Provider (IdP).
- Name
idpMetadataUrl?- Type
string- Description
The URL which serves the Identity Provider (IdP) metadata. If present, it takes priority over the corresponding individual properties.
- Name
idpMetadata?- Type
string- Description
The XML content of the Identity Provider (IdP) metadata file. If present, it takes priority over the corresponding individual properties.
- Name
attributeMapping?- Type
{ emailAddress?: string, firstName?: string, lastName?: string, userId?: string }- Description
The attribute mapping for the SAML connection.
const response = await clerkClient.samlConnections.createSamlConnection({
name: 'test-okta',
provider: 'saml_okta',
domain: 'clerk.dev',
idpMetadataUrl: 'https://trial-000000.okta.com/app/exk...',
attributeMapping: {
emailAddress: 'user.email',
firstName: 'user.firstName',
lastName: 'user.lastName',
},
})Backend API (BAPI) endpoint
This method in the SDK is a wrapper around the BAPI endpoint POST/saml_connections. See the BAPI reference for more information.
Feedback
Last updated on