Apple
Setting Up Sign In With Apple Integration
This step-by-step guide details how to set up an Apple social login integration in Wristband.
Step 1: Locate Your External IdP Callback URL
- In the Wristband dashboard, enter Application View for the application you want to integrate with Apple.
- Navigate to the
Identity Providers > Socialmenu in the side navigation. - After landing on the Social Identity Providers page, select the Apple provider icon.
Figure 1:
Copy the "Redirect URL" from the form.
Figure 2:
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
From the Developer Console home page, click on "Identifiers."
figure 3:
Click the "+" button to start the registration process.
Figure 4:
Select "App IDs" and click "Continue."
Figure 5:
Select "App" for the type of identifier.
Figure 6:
Fill out the form:
- Description: Any appropriate value.
- Bundle ID: Choose "Explicit." Any appropriate value, usually the reverse domain of your application.
Figure 7:
Select the "Sign In with Apple" checkbox. Additional configuration is optional.
Figure 8:
Click "Continue." Copy the "App ID Prefix" (Team ID) value.
Figure 9:
Click "Register" to complete the App Identifier registration.
Step 4: Register A Service Identifier
Click the "+" button on the Certificates, Identifiers, & Profiles page.
figure 10:
Fill out the form:
- Description: Any appropriate value.
- Identifier: Any appropriate value, usually the reverse domain of your application.
figure 11:
Click "Continue." Copy the "Identifier" (Service ID) value.
Figure 12:
Click "Register." Click the row for the Service Identifier you just created to edit its configurations.
Figure 13:
Enable "Sign In with Apple" and click "Configure."
Figure 14:
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.
Figure 15:
Confirm the configurations and click "Done."
Figure 16:
Click "Save" to persist the changes.
Figure 17:
Step 5: Register A Sign In With Apple Key
Navigate to the Keys menu. Click the "+" button to start the key registration process.
Figure 18:
Check the "Sign in with Apple" option. Click "Configure."
Figure 19:
Select the App ID you created in step 3 from the "Primary App ID" dropdown. Click "Save."
Figure 20:
Click "Register" on the preview screen.
Figure 21:
Download your key.
Copy the "Key ID" value and download the PEM key file.
Figure 22:
Click "Done." You have now configured everything necessary on Apple's side for social login integration.
Step 6: Configure the Apple IDP in Wristband
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.
By default, the following scopes will always be requested during authorization with Apple (additional scopes are optional):
- name
Click "Save" to finish. The Apple External IDP will be in an ENABLED status.
Figure 23:
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 (unless Tenant Overrides are enabled for a particular tenant).
Figure 24:
Updated about 15 hours ago