Prerequisites
Before you can connect your Apple Developer account you'll need to register for the Apple Developer Program.
You'll need to be the Account Holder to complete the steps in your Apple Developer account.
How to Connect Your Apple Developer Account
Warning
If you experience an issue with any of the connection steps, please save your progress and then contact success@supapass.com with a screen recording of the issue.
Step 1 - Start connecting your account
Note
If you previously connected an account before September 2023 you still need to connect to the new App Setup to receive updates.
Click on App Setup.
Under Connect Accounts, click 'Connect Apple Account'.
Click the Connect New Account button. If you have previously used this new process to connect another channel, select Select Existing Account.
Give your account a Reference Name. This is used to identify the Apple Developer account within SupaPass. Use an appropriate name, such as your company name.
Top Tip! 😊 We recommend setting up your two browser windows side by side
Have your SupaPass Dashboard open on left side of your computer screen
Have your Apple App Store Connect dashboard open on the right side of your computer screen
so you can easily move between both dashboards - we will be copying and pasting various IDs and other information, so having easy access to both will be really helpful.
Step 2 - Generate the API key file
Now, login to your App Store Connect with your Apple Developer account credentials.
Under the App Store Connect section, click 'Users and Access'.
Click on the 'Integrations' tab, then click the plus button to generate your key. If this is the first time generating a key, the Account Owner will first need to select the Request Access button.
To generate an new API Key, enter a sensible name for the key and give the access level 'Admin'. Then click the Generate button.
Hover over the entry in the table, click 'Download API Key' and keep it somewhere secure. Save with the original file name, or else the account connection will fail.
Return to the SupaPass Dashboard and upload the Key file (.p8).
Step 3 - Add the App Store Connect API Key ID
Next, copy and paste the App Store Connect API Key ID which can be found on the same page in App Store Connect.
Step 4 - Add the Issuer ID
Now, copy and paste the Issuer ID which can be found on the same page in App Store Connect.
Step 5 - Generate the Shared Secret
From the Left menu, select 'Shared Secret'.
Click 'Generate Shared Secret'.
Copy the Shared Secret and paste it into the Shared Secret field in SupaPass.
Step 6 - Add the Account Holder's Apple ID
Return to App Store Connect and click on the 'People' tab.
Click on the Account Holder profile.
Copy the Apple ID Email address and paste it into the field in SupaPass.
Give the account a reference name and click 'Next'.
Step 7 - Upload APNs API Key file
The final three steps are to set up the notifications for your app and add some developer information.
IMPORTANT: These next steps relate to your Apple Developer account, not App Store Connect.
Login to developer.apple.com and click 'Keys' under the Certificates, IDs & Profiles section.
Click the blue plus button to generate a new Key.
Give the Key a name, select 'Apple Push Notifications service (APNs)', click Continue and then Register.
On the next screen you'll have the option to download the key, which cannot be re-downloaded. So download the key file and keep it somewhere secure. Save with the original file name, or else the account connection will fail.
Upload the key file to SupaPass. Make sure that the key is the newly generated .p8 file and not the same key generated in step 1. You can check you're uploading the correct file as the file name will match the Key ID from the Certificates, Identifiers & Profile page in App Store Connect.
Step 8 - Add your Apple Developer information
As before, this step relates to your Apple Developer account, not App Store Connect.
Login to developer.apple.com and click 'Membership details'.
Copy the Team ID.
Paste the Team ID into SupaPass.
Step 9 - Add your Entity Name or your name
Next, return to your Apple Developer Membership details.
If you're enrolled as an Organization: - Copy the Entity Name,
If you're enrolled as an individual: - use the Developer Name in the top right (this is your personal name that you registered with).
Paste the name into SupaPass.
Step 10 - Add your Company Name
If you enrolled in the Apple Developer Program as an Organization, you may set a different developer name if it's a registered trade name, DBA, or fictitious business name. For example, if your legal name is “Apps Company LLC”, your trade name may simply be “Apps Company”, which can be used on the App Store. It can't be edited or updated later, so it's important to add it correctly.
If you are using a Personal account, or are connecting an account that already has apps you will not be able to set a Company Name. Simply add the Team Name here from the previous step.
Step 11 - Submit to connect your account
Check all of the details are correct and then click 'Submit' to connect your account to SupaPass.
Step 12 - Secure the API Keys
You should now take steps to secure the API keys downloaded to your device, this key cannot be downloaded again and is highly sensitive, so either delete it after connecting your account or store it securely in a password manager such as 1Password.
🚀 That's it! You've now given SupaPass access to automatically generate your app builds directly from your SupaPass Dashboard!