Apple

Overview

This article provides step-by-step instructions on configuring Apple Developer Console with your Gigantik marketplace. OIDC authentication allows collectors to securely authenticate and access your Gigantik Marketplace using their existing Apple account/credentials.

Prerequisites

• An active Apple Developer account
• Access to the Gigantik CMS

Accessing the Apple Developer Console

1. Open your web browser and navigate to the Apple Developer Console website.
2. Sign in with your Apple Developer account credentials.
3. Once logged in, locate and click on Certificates, Identifiers, and Profiles

Creating an App ID for Sign In with Apple

1. In the Certificates, Identifiers, and Profiles menu, click on Identifiers.
2. Click the "+" button and choose to create a new App ID.
3. Select App as the type.
4. Provide a name and a bundle ID for your App ID.
5. Under capabilities, enable Sign In with Apple.
6. Save the App ID to create it.

🚧

This process may change based on decisions at Apple. Please see the official documentation:

https://support.staffbase.com/hc/en-us/articles/115003535352-Creating-the-iOS-App-ID

Creating a Service ID

1. Return to the Identifiers menu and click the "+" button once again to create a new Service ID.
2. Pick a name for the Service ID and enter an identifier. The identifier will be used as your OIDC client ID.
3. Save the Service ID.

Configuring Sign-In with Apple

1. Click on the newly created Service ID.
2. Enable the Sign In with Apple capability.
3. Click Configure next to Sign In with Apple.
   1. Choose your App ID from the available options.
   2. For the domains, enter your marketplace domain. For example, enter "example.shops.gigantik.io"
   3. In the Return URLs section, enter the root of your marketplace URL, including the trailing slash. For example, enter "https://example.shops.gigantik.io/"
4. Save the changes to your Service ID.

Configuring the OIDC Provider in the Gigantik CMS

1. Log in to the Gigantik CMS
2. Navigate to Marketplace > OpenID Connect

3. At the top right of the Open ID Connect screen, click the Add OpenID Connect Provider button
   1. Provide a name for the OIDC provider (e.g. "Apple").
   2. In the Discovery Endpoint field, enter "https://appleid.apple.com/.well-known/openid-configuration"
   3. In the Client ID field, enter the Client ID obtained from Step 2 of Creating a Service ID
   4. Optionally, you may provide a button image for the OIDC Provider to enhance the user interface.

4. Save the configuration settings.

Conclusion:

By following the steps outlined in this article, you should now have successfully set up OIDC authentication for your Gigantik Marketplace using Apple as the identity provider. With this setup, collectors can now authenticate securely and access your Gigantik marketplace using their Apple credentials.

For further information about advanced configuration options, refer to the official Apple documentation.