Sign In with Apple

From Fall '19, iOS mobile apps must display Sign In with Apple if they already use other social providers (Facebook login, Google connect, and so on).

Even if it’s mandatory only for your iOS App using Facebook and/or Google connect, we highly recommend to push the "Sign In with Apple" option also on your websites to offer a consistent authentication experience to your customers.

To use Sign In with Apple, you will need an App ID, a Service ID, and a Key.

This document details, step by step, how to create an Apple Application and connect it to your ReachFive account.

Open https://developer.apple.com/ then click Accounts.

Then, choose Certificates, Identifiers & Profiles.

apple 1

1. Create your App ID

Choose Identifiers and click on the blue plus icon

apple 2

Choose App IDs and click on Continue

apple 3

Write a App description. Next to Bundle ID, select Explicit and define an ID using reverse domain name style string as described + "-app") and . For example, if your app domain is demo.io, we use io.demo-app.

apple 4

Scroll down, check Sign In with Apple, click Continue, then Register.

2. Create your App Services ID

You’ll be able to create multiple App Services ID to match with all your domains.

Go to the Identifier section and click on the blue logo to register a new Services ID.

apple 5

Choose Services IDs and click Continue.

apple 6

Fill the description text box and identifier and tick Sign In with Apple to enable the feature.

Click Continue to save, then click Register.

Go back to the Identifier section, filter on Services IDs.

apple 7

Click on the Service you just created. Tick Sign In with Apple checkbox then click Configure.

apple 8

Select your App ID in the first section.

In the domain section, insert your ReachFive domain. ReachFive domain available here: https://console.reach5.co/{REACHFIVE_DOMAIN}/admin/settings

In return URL, insert your Callback URL: https://{REACHFIVE_DOMAIN}/login/callback

Click on Next then Done.

Click Continue and then Save.

3. Create your Private Key

Choose Keys and click on the blue plus icon.

apple 12

Give your Key a name and check "Sign In with Apple".

apple 13

Then click on Configure and define your Primary App ID (as defined in step 1), then click Register.

apple 14

Then click on Download and save the file with the .p8 extension.

Make sure you save this file because it cannot be re-downloaded.

4. Configure ReachFive Back-Office

Log in into ReachFive, then go on Settings  Provider  Apple Sign.

apple 15

Report your Client ID, Team ID and Key ID to ReachFive back-office.

  • Your Key ID is available in the Key configuration you just set.

    apple 16
  • The client ID is the Services ID Identifier.

  • The Team ID is the alphanumeric suite before the reverse domain name

    apple 17

Open the .p8 file you saved earlier and copy it in Private Key section.

apple 18

Don’t forget to copy -----BEGIN PRIVATE KEY----- XXX -----END PRIVATE KEY-----.

  • To be able to collect user data, click permissions and add:

    • email

    • name

apple 21

The data that you will collect requires user consent. Users can choose to mask their email address, so you will need to configure your SMTP server to be able to use Apple’s private email relay service.

Get your App compliant

On https://developer.apple.com/, go to More  Configure.

apple 19

Click Download.

apple 20

Copy and Paste the downloaded files from your Apple configuration in ReachFive Back

Going further

Guidelines

If you want to implement your own button and not use our widget, follow Apple Guidelines.

Conclusion

That’s all you need to implement Sign In With Apple on your mobile app.