> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Sign-in

> Integrate Apple Sign-In into your OwnID authentication screens

<img width="200" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/google/aireuropa-google.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=4aa76c77ca7625da00e4d4c70c44a860" alt="Apple Example" data-path="images/google/aireuropa-google.png" />

This guide walks you through the steps to set up Apple Sign-In as an identity provider within the OwnID platform, offering a secure and frictionless login experience.

## Prerequisites

Before you begin, ensure you have the following:

* An Apple developer account and access to [Apple Developer Console](https://developer.apple.com/).
* An OwnID account and access to the [OwnID Console](https://console.ownid.com/).

## Step 1 - Setup sign in with Apple on Apple Developer

1. Open the [Certificates, Identifiers & Profiles page](https://developer.apple.com/account/resources).
2. Click *Identifiers* in the sidebar, then click the add button (+) on the top left.

<img width="500" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/apple/1_identifiers.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=a0843276d76f4d8b12b5df4cf9e28d3b" alt="Identifiers" data-path="images/apple/1_identifiers.png" />

<sup>Figure 1. Identifiers</sup>

3. Select *App IDs*, then click Continue.

<img width="500" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/apple/new_identifier.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=c5d7d822f4fc20ef87cb6315bc050dac" alt="New Identifier" data-path="images/apple/new_identifier.png" />

<sup>Figure 2. Register a New Identifier</sup>

4. In the *Register an App ID* page, choose `iOS` as the platform, enter some description and enter your *Bundle ID*.

5. In the list of capabilities, check *Sign in with Apple*.

6. Go back to the *Identifiers* page, and again click the add button (+).

7. Select *Services IDs*, then click Continue.

<img width="500" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/apple/4_new_identifier_svc.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=e0253fdf25200e11299bd30a024dd5ec" alt="New Identifier" data-path="images/apple/4_new_identifier_svc.png" />

<sup>Figure 2. Register another Identifier</sup>

8. Enter a *Description* and an *Identifier*. The identifier will be later used as our `Apple Service ID`, so save it for later use.

9. Check *Sign in with Apple*, then click the *Configure* button next to it.

10. For the *Return URLs* please enter your [custom domain](/explore/custom-domain), followed by the path `/oidc/callback`, so for example `https://passwordless.acme.com/oidc/callback`. If a custom domain was not configured yet, you can enter `https://passwordless.ownid.com/oidc/callback`.

11. Click *Save* and then *Continue* and *Register*.

12. Back in the main *Certificates, Identifiers & Profiles* screen, choose *Keys* from the side navigation.

13. Click the plus icon (+) to register a new key. Give your key a name, and check the *Sign In with Apple* checkbox. Click *Configure*.

14. Choose your *Primary App ID* and click *Save*.

15. Download the key and save it in a secure location. You will need it later.

16. Go back to view the key information to find your *Key ID*, save it for later use.

## Step 2 - Configure in OwnID

Go to the OwnID console, `Authentication` > `Social Providers`:

* Toggle on `Apple Sign in`.

  <img width="500" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/apple/apple-toggle.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=468f3d25883af6ba74b953ca253f15a0" alt="Google toggle" data-path="images/apple/apple-toggle.png" />

<Note> By default, OwnID testing credentials are provided, but they are strictly for development use only. Follow this tutorial to configure your own Google credentials for production. </Note>

* Click **configure** and enter the following values in the modal:

<img width="500" src="https://mintcdn.com/ownid/R0Wddcq9zgBDU03F/images/apple/apple-console-config.png?fit=max&auto=format&n=R0Wddcq9zgBDU03F&q=85&s=92195d3c30387ed79d7f1283bbbfddbd" alt="Apple console config" data-path="images/apple/apple-console-config.png" />

* `Apple Service ID` is the *Identifier* you created in the *Services IDs* section in the Apple Developer portal.
* `Apple Private Key` is the value of the private key you downloaded, including the `-----BEGIN PRIVATE KEY-----...` padding.
* In the `Apple Team ID` field, enter your Apple Developer Team ID.
* In the `Apple Key ID` field, enter the *Key ID* you got from the Apple Developer portal.

## Apple Configuration for whitelisting Senders for sending emails to apple email-relays

* Log in to your [Apple Developer Account](https://developer.apple.com/).
* Navigate to Certificates, Identifiers & Profiles.
* In the sidebar, click Services.
* Find Sign in with Apple for Email Communication and click Configure.

<img width="500" src="https://mintcdn.com/ownid/sXNhS7l6Ygrz3H8q/images/apple/Apple_for_Email.png?fit=max&auto=format&n=sXNhS7l6Ygrz3H8q&q=85&s=e094d3cdcad63787242300a682bef202" alt="Email Communication" data-path="images/apple/Apple_for_Email.png" />

* In the Email Sources section:
* To register a domain: Click the plus (+) icon and enter your domain (e.g., example.com).
* To register specific emails: Use the same section to add individual addresses (e.g., [support@example.com](mailto:support@example.com)).

<img width="500" src="https://mintcdn.com/ownid/sXNhS7l6Ygrz3H8q/images/apple/Email_Sources.png?fit=max&auto=format&n=sXNhS7l6Ygrz3H8q&q=85&s=261fd2893aabbeba68f79000bcd85c0b" alt="Email Sources" data-path="images/apple/Email_Sources.png" />

<img width="500" src="https://mintcdn.com/ownid/sXNhS7l6Ygrz3H8q/images/apple/register.png?fit=max&auto=format&n=sXNhS7l6Ygrz3H8q&q=85&s=92562e702f02e468ea9e30b875c15f69" alt="Email Registration" data-path="images/apple/register.png" />
