Apple
Apple#
Pre-requisites#
Before configuring "Sign in with Apple" you must first join the Apple Developer Program and pay for a full developer account. You must also ensure your site is available over an SSL (https) connection with a valid certificate.
Creating a new application#
- Log in to your Apple Developer Account.
- Under "Certificates, IDs & Profiles" click Identifiers.
- Click the "plus" icon followed by "App IDs" and click "Continue".
- Select "App" as the type and click "Continue".
- Note down the value of "App ID Prefix" which is your "Team ID". This will be needed later.
- Enter a "Description" and with "Explicit" selected, type a "Bundle ID". Reverse-domain name style is suggested, but it doesn't have to match your domain name exactly. We will choose
com.xenforo.community
. - Under "Capabilities" find "Sign In with Apple" and click the checkbox.
- Click "Save" and when the page reloads click "Register".
- Once you have returned to the list of "Identifiers" click the "plus" icon again, but this time select "Services IDs" before clicking "Continue".
- Provide a "Description" and an "Identifier". We recommend using your board/site title for the description. For the identifier, once again, reverse-domain name style is suggested. We will choose
com.xenforo.community.service
. - Click "Continue" followed by "Register".
- Back on the "Identifiers" list, ensure the list is filtered by "Services IDs" in the top right corner of the list.
- Click the "Services ID" you just created.
- Find "Sign In with Apple" in the list and click "Configure".
- In the overlay that appears you need to provide the actual domain name for your website in the "Domain and Subdomains" field. We will choose
xenforo.com
. - Under "Return URLs" you need to type your board URL and its
connected_account.php
URL. Therefore, we will choosehttps://xenforo.com/community/connected_account.php
. - Click "Next" followed by "Done" to close the overlay. Now click "Continue" followed by "Save".
- You should be returned back to the "Identifiers" list. In the left-hand navigation, click "Keys".
- On the "Register a New Key" page, enter a "Key Name".
- Find "Sign in with Apple" in the list below, click the checkbox and click "Continue".
- Under "Primary App ID" select the app ID you created in steps 3-8, followed by "Save".
- Click "Continue" followed by "Register".
- You must now click "Download" to download the key and note the "Key ID".
Configuring Sign In with Apple connected account#
- Log in to the Admin Control Panel.
- Go to Setup > Connected accounts.
- Click on Apple in the list.
- Enter your "Team ID" which you noted down in step 5 in the section above.
- Enter your "Services ID" which you created in step 10 above, e.g.
com.xenforo.community.service
. - Enter your "Key ID" which you noted down in step 23 above.
- Use the "Choose file" button to upload the key you downloaded in step 23 above.
- Test the connected account
Configuring Email for Apple Private Relay support#
Apple iCloud customers can hide their email addresses when using Sign in with Apple. This sets up a randomised, anonymous email forwarder to their real email address. To enable seamless transmission of email to these Apple users, you must tell Apple about your mail domain names and email addresses.
- Log in to your Apple Developer Account.
- Under "Certificates, IDs & Profiles" click Services.
- Under "Sign in with Apple for Email Communication" click "Configure".
- Click the "plus" icon next to "Email Sources" to open the "Register your email sources" overlay.
- Under "Domains and Subdomains" enter your email domain(s), e.g.
xenforo.com
. - Under "Email Addresses" enter your default email address as configured in your Admin control panel, e.g.
contact@xenforo.com
. - Click "Next" followed by "Register", followed by "Done".