Custom Apple Identity Provider

Last updated 11/23/2021

Step 1

Sign in to your Apple Developer account: https://developer.apple.com/

Step 2

  • On the left pane, click Certificates, IDs & Profiles, then select Identifiers.
  • Click the blue + button to add a new identifier.
Step 2

Step 3

Select App IDs and click Continue.
Step 3

Step 4

For type, select App and click Continue.
Step 4

Step 5

  • For Description, enter your organization's name.
  • For Bundle ID,  enter a reverse-domain name style string (i.e., com.domainname.appname).
  • Take note of your Team ID, this will be used later.
Step 5

Step 6

  • Under Capabilities, check "Sign in with Apple".
  • Click Continue.
Step 6

Step 7

Confirm your information and click Register.
Step 7

Step 8

  • Navigate to Services IDs by using the dropdown on the right.
  • Click the blue + button to add a new identifier.
Step 8

Step 9

Select Services ID and click Continue.
Step 9

Step 10

  • Add a Description and Bundle ID (must be different than your App ID description and Bundle ID).
  • Click Continue.
Step 10

Step 11

Confirm your information and click Register.
Step 11

Step 12

Click on your Service ID.
Step 12

Step 13

  • Select Sign in with Apple.
  • Click Configure beside Sign in with Apple.
Step 13

Step 14

  • Select the App ID you created as the Primary App ID.
  • For Domains and Subdomains, enter api.breadbutter.io
  • For Return URLs, enter https://api.breadbutter.io/callback
  • Click Next.
  • Confirm your web authentication configuration and click Done.
Step 14

Step 15

  • On the left pane, select Keys.
  • Click the blue + button to add a new key.
Step 15

Step 16

  • Select Sign in with Apple.
  • Click Configure.
Step 16

Step 17

  • For Primary App ID, select your app ID.
  • Click Save.
  • Confirmed your information and Register.
Step 17

Step 18

  • Take note of your Key ID.
  • Download your Key. Your key can only be downloaded once.
Step 18

Step 19

BreadButter Setup:

  1. Go to breadbutter.io
  2. Click Sign In and authenticate (or Sign Up make a new account and authenticate).
  3. Navigate to Providers, then to Default Rules (or Domain Rules and open/create a domain module).
  4. Click Sign in with Apple button.
  5. Select "Set Apple for Production".
  6. Enter a custom name and description.
  7. Enter the Key ID from the setup steps above.
  8. Enter the Team ID from the setup steps above.
  9. Enter the Key from the setup steps above.
  10. Click Save & Close.
  11. Click the checkbox next to your new Apple provider to enable it.
NOTE: When editing an existing Apple custom provider, the Key ID, Team ID, and Key will not be displayed. However, you can expand the fields to edit them if needed, but you will need to update all 3 fields to submit.