Authorization for Shopper APIs

Learn how to set up the Shopper Login and API Access Service (SLAS) so that you can request access tokens for Shopper APIs.

Shopper APIs are secured with the Shopper Login and API Access Service (SLAS), but Admin APIs are secured with Account Manager instead. This guide only covers how to access the Shoper APIs. To learn how to access the Admin APIs, see Authorization for Admin APIs.

To get you up and running as fast as possible, the instructions provided here use a web application called the SLAS Admin UI. If you require additional configuration options or are building automated setup tools, you can also use the SLAS Admin API instead of the UI.

(You must have the Account Administrator role in Account Manager to do this task. If you get stuck, ask an administrator on your team for help or contact Support.)

For each user performing the SLAS administration tasks described in this guide, follow these steps to set up their roles and filters:

  1. Log in into Account Manager.

  2. Click User from the left navigation.

  3. Click the user’s ID.

  4. Scroll down to Roles and click Add.

    Associated screenshot -medium

  5. Enter "slas" in the filter search box.

  6. (If you see no results, the role has likely been added already, so you can click Cancel and skip to step 9.)

  7. Select SLAS Organization Administrator.

    Associated screenshot -small

  8. Click Add.

  9. Look for the SLAS Shopper Admin API category with the SLAS Organization Administrator role below it.

  10. Click the filter button next to the SLAS Organization Administrator role.

    Associated screenshot -medium

  11. Select an organization.

  12. Select the hostnames for specific B2C Commerce instances that you want to configure. You can also select All Sandboxes instead of selecting each sandbox individually.

  13. Click Add.

    Associated screenshot -small

  14. Scroll down to the bottom of the page.

  15. Click Save.

(It can take up to 15 minutes for role changes to propagate and take effect.)

The easiest way to create a SLAS client is to use the SLAS Admin UI. To access the SLAS Admin UI, replace {{short-code}} in the following URL with the short code used by your B2C Commerce instances:

To learn more about Commerce Cloud short codes, see the Configuration Values guide.

Repeat these steps to create a SLAS client for each B2C Commerce instance that requires access to Shopper APIs:

  1. Log in to the SLAS Admin UI using your Account Manager credentials.

  2. From the top navigation, click Clients.

  3. Click Add Client.

  4. Click Choose Tenant... and select a B2C Commerce instance.

  5. Select an app type with the “Which App Type will be used?” field:

    • Choosing PWA Kit or SFRA or Mobile creates a public client (no secret generated).
    • Choosing BFF or Web App creates a private client (secret generated automatically).
  6. Click Submit.

Now you can use your SLAS client to request an access token for Shopper APIs!

If your app type is BFF or Web App, the automatically generated secret is displayed at the top of the results page.

Associated screenshot -large

A secret can only be displayed once for security reasons, so be sure to copy it and save it in a secure location whenever you create a client for a BFF or Web App.

To generate a new secret for an existing client:

  1. From the top navigation, click Clients.
  2. Click the Edit link next to the client ID that you created earlier.
  3. Change the app type to PWA Kit or SFRA or Mobile.
  4. Click Save.
  5. Click the Edit button.
  6. Change the app type back to BFF or Web App.
  7. Click Save.
  8. Copy the secret at the top of the results page.

If you’re planning to do a phased rollout of a PWA Kit experience, you must also create a redirect URI and add associate it with your API client.

To create the redirect URI, replace PLACEHOLDER_HOSTNAME and PLACEHOLDER_SITE_ID in the following string with actual values for your B2C Commerce instance:

To associate the redirect with your API client, follow these steps in the SLAS Admin UI:

  1. From the top navigation, click Clients.

  2. Click the Edit link next to the client ID that you created earlier.

    Associated screenshot -large

  3. In the redirect field, append a | character followed by the redirect URI that you just created.

    Associated screenshot -large

  4. Click Save.

If you already created your SLAS clients using the SLAS Admin UI, you can skip this section.

The SLAS Admin API offers an alternative to the SLAS Admin UI that makes it easier to automate SLAS administration tasks, such as creating public and private clients. The API also allows you to access a wider range of configuration options.

Get a SLAS Admin Token

To access the SLAS Admin API, use the SLAS Admin UI to get an admin token:

  1. Log in to the SLAS Admin UI.
  2. Click Token from the top navigation.
  3. Click Copy Admin Token to Clipboard. (The token will expire after 30 minutes.)

Associated screenshot -large

An admin token is not the same as a SLAS access token. An admin token can only be used to access the SLAS Admin API, not Shopper APIs.

Set Environment Variables

To form your API requests correctly, it helps to set some environment variables first.

If you’re not using a Unix-based operating system, you can adapt the commands for setting environment variables or manually replace the variables later in the curl command provided.

To store the admin token, replace {{clipboard_contents}} in the following command by pasting the token that you just copied from the SLAS Admin UI:

Before running the next series of commands, replace zzte, 053, and kv7kzm78 with your realm ID, instance ID, and shortcode. To learn more about these identifiers, including how to look them up in Business Manager, see the Configuration Values guide.

Create a SLAS Tenant

Now that your environment variables are set, you can start making requests to the SLAS Admin API. To create a SLAS tenant (or update an existing one) and associate it with a B2C Commerce instance, make a request to the tenants endpoint like this:

Create a SLAS Client

To create a SLAS client using the SLAS Admin API, you must provide some additional configuration information, starting with a client ID.

Client ID

Your client ID must be universally unique identifier (UUID). There are lots of ways to generate a UUID, but we recommend that you go to uuidgenerator.net and click Copy at the top of the page. The identifier must follow the UUID version 4 format: 36 characters long, including 3 hyphens.

To store the client ID in an environment variable for your API requests, replace f58d60fd-9230-4ed7-90a4-ee11b5e7f27b in the following command with the UUID that you generated:

Client Secret

If you’re creating a private client, you also must create a secret (a password) for your SLAS client. We recommend using a password manager to generate and store the secret.

To store the secret in an environment variable for your API requests, replace D*HHUrgO2%qADp2JTIUi in the following command with your secret:

You can also create and store your client ID and secret in Account Manager. For detailed instructions, see Add an API Client on the B2C Commerce Infocenter.

JSON Data

For creating both public and private clients, you must provide JSON data in the request body that controls important settings for SLAS:

  • The channels array allows you to associate the SLAS client with one or more channels. A channel is what we call the string used to identify a particular ecommerce site.
  • The scopes array lists all the API families that the SLAS API has access to.
  • The redirectUri array allows specific URIs for redirects. Wildcard characters (*) are supported for hostnames.

In the example requests provided, we’ve populated the request body with some common settings that you can customize for your application.

Example Request: Create a Public SLAS Client

To create a public SLAS client, run this command:

Since the request is for setting up a public client, no client secret is required.

Example Request: Create a Private SLAS Client

To create a private SLAS client, run this command:

Now that you know how to set up SLAS clients, it’s time to make some API requests! Learn how to formulate your API requests with the last guide in the Get Started series: Base URL and Request Formation.

To learn more about using public SLAS clients and private SLAS clients to access the Shopper APIs, see the SLAS guides.

For more technical details on the capabilities of the SLAS APIs, explore the API specifications in the Reference section:

To learn how to access the Admin APIs, see Authorization for Admin APIs.