Apple

Setting Up Sign In With Apple Integration

Learn how to configure Apple social login in Wristband with this step-by-step guide.

Step 1: Locate Your External IdP Callback URL

1. In the Wristband dashboard, enter Application View for the application you want to integrate with Apple.

2. Navigate to the Identity Providers > Social menu in the side navigation.

3. After landing on the Social Identity Providers page, select the Apple provider icon.

4. Copy the Redirect URL from the form.

Step 2: Sign Up/Login to Your Apple Developer Account

Create or log in to your Apple Developer account here. You will need to create and configure three entities:

• An App Identifier
• A Service Identifier
• A Sign In With Apple Key

Step 3: Register An App Identifier

1. From the Developer Console home page, click on Identifiers.

2. Click the Identifiers + to start the registration process.

3. Select App IDs and click Continue.

4. Select App for the type of identifier.

• Description: Any appropriate value.
• Bundle ID: Select Explicit. Any appropriate value, usually the reverse domain of your application.

6. Select the Sign In with Apple checkbox. Click Continue. Additional configuration is optional.

7. Copy the App ID Prefix (Team ID) value.

8. Click Register to complete the App Identifier registration.

Step 4: Register A Service Identifier

1. Click the Identifiers+ button on the Certificates, Identifiers, & Profiles page.

2. Select Service IDs and click Continue.

2. Fill out the form:

• Description: Any appropriate value.
• Identifier: Any appropriate value, usually the reverse domain of your application.
• Click Continue.

3. Copy the Identifier (Service ID) value and Click Register.

4. Click the row for the Service Identifier you just created to edit its configurations.

5. Enable Sign In with Apple and click Configure.

6. Fill out the Web Authentication Configuration form:

• Primary App ID: The App Identifier from step 3.
• Domains and Subdomains: Your Application Vanity Domain or custom domain.
• Return URLs: Paste the External IdP Callback URL from step 1.
• Click Next.

7. Confirm the configurations and click Done.

8. Click Save to persist the changes.

Step 5: Register A Sign In With Apple Key

1. Navigate to the Keys menu. Click the + button to start the key registration process.

2. Check the Sign in with Apple option. Click Configure.

3. Select the App ID you created in step 3 from the Primary App ID dropdown. Click Save.

4. Click Register on the preview screen.

5. Copy the Key ID value and download the PEM key file.

6. Click Done. You have now configured everything necessary on Apple's side for social login integration.

Step 6: Configure the Apple IdP in Wristband

1. Return to the Wristband dashboard to the Social Identity Provider Page from step 1. Fill out the form with the following values:

   • Team ID: The App ID Prefix value from step 3.
   • Service ID: The Identifier value from step 4.
   • Key ID: The Key ID value from step 5.
   • Private Key: The Key PEM file from step 5.
     • Open the file and copy the contents into the form.

2. By default, the following scopes will always be requested during authorization with Apple (additional scopes are optional):

   • email
   • name

3. Click Save to finish. The Apple External IdP will be in an ENABLED status.

4. At this point, the application has successfully completed an Apple social login integration. The next time users in this application reach the Tenant-level Login Page, they should see an Apple login button.