younifyd
Menu

Start Webauthn Authentication

Start WebAuthn authentication

POST/organizations/{organizationId}/oauth2/webauthn/authenticate/start

Use it in a workflow

  1. Add a step and choose the Salesforce Commerce Cloud connector.
  2. Pick the Start Webauthn Authentication action (under Auth (SLAS)).
  3. Fill in the fields below, then reference the result from later steps as {{startWebauthnAuthentication.response.data}}.

Request

Path parameters

organizationIdstringrequired

An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/get-started.html) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/get-started.html#instance-types).

Headers

Authorizationstring

Base64-encoded string for HTTP Basic authentication. The string is composed of a client ID and client secret, separated by a colon (`:`). For example: `clientId:clientSecret`.

Request body

Enter the body as JSON in the step's Body field.

tenant_idstring

The ID of the tenant.

client_idstringrequired

The ID of the OAuth client.

channel_idstringrequired

The ID of the channel.

user_idstring

The ID of the user.

json
{
  "client_id": "12345678-1234-1234-1234-123456789012",
  "channel_id": "RefArch",
  "tenant_id": "zzte_053",
  "user_id": "user@example.com"
}

Response

Returns 200 with an object. Read it in later steps with {{startWebauthnAuthentication.response.data.<field>}}.

challengestring

Base64url-encoded challenge.

timeoutinteger

Timeout value in milliseconds.

rpIdstring

The ID of the relying party.

allowCredentialsarray<object>

Allowed credentials for authentication.

typestringrequired

Credential type.

One ofpublic-key

idstringrequired

The base64url-encoded ID of the credential.

transportsarray<string>

Authenticator transports.

userVerificationstring

The level of requirement for user verification.

One ofrequiredpreferreddiscouraged

extensionsobject

WebAuthn extensions.

json
{
  "challenge": "V2FsdGVyIFdoaXRlIFRlc3QgQ2hhbGxlbmdl",
  "timeout": 60000,
  "rpId": "example.com",
  "allowCredentials": [
    {
      "type": "public-key",
      "id": "AQIDBAUGBwgJCgsMDQ4PEA",
      "transports": [
        "internal",
        "usb"
      ]
    }
  ],
  "userVerification": "preferred",
  "extensions": {}
}

Need more? See the Salesforce Commerce Cloud guide for connection setup and behaviour shared by every action.