Okta

Create an Okta account and configure credentials

If you already have an Okta account, you can skip the first two steps and start directly with step 3.

1. For testing purposes you can create a Integrator Free plan at https://developer.okta.com/signup/

2. Follow the installation steps.

3. Login into your Okta account administration

4. Click at Applications -> Applications -> Create App Integration.

5. Choose OIDC - OpenID Connect as Sign-in method and Web-Application as Application type and click Next.

6. Enter an App integration name that can help you to identify the purpose of this integration. Please ensure that Grant type has the value Authorization Code.

7. Enter the Enter the Sign-in redirect URIs from your configured Okta service in Shopware. If you haven't configured it yet you can follow our guide at Configure Okta in Shopware extension. Clear the value of the field Sign-out redirect URIs.

8. Configure which one of your organisation is allowed to sign it by choosing a Controlled access at Assignments. Don't forgett to uncheck the Enable immediate access with Federation Broker Mode option.

9. Click Save to create your new app integration.

Configure Okta in Shopware extension

For detailed information follow the guide for managing the SSO providers. See screenshot to be aware of the required fields for Okta implementation.

You can find the required credentials (clientId, providerUri and clientSecret) in your created app integration of the Okta account.

If you use the Okta template, all required mapping fields are already pre-configured.

Add/ edit user in Okta directory

To enable your Okta directory users to sign in at Shopware storefront, you need to add them to your directory.

1. At Directory -> People you'll find a list of all your current directory users. With button Add person you can enrich the directory with more users. So first of all: Create all users you'll need for the Shopware storefront login by Okta.

2. Choose the app integration at Applications -> Applications which you have created in your Okta account.

3. Switch to tab Assignments. Here you can find all users, which are currently added for the app integration. By clicking Assign -> Assign to people you can add more users. By clicking the pencil at person list, you can edit a user.

4. Please ensure that every person has all fields filled, that are required for Shopware. Required fields are: - Username - Name - Given Name - Family Name - Email - Street Address - Postal Code - Country After entering all information click Save button.