iOS Unlisted Apps

What is an unlisted app?

An Unlisted app is an app that although hosted in the public App Store it is not publicly indexed and it is distributed via a single URL. This means it will be necessary to have a specific link to download it and it won’t be able to be found via the regular App Store name search. This makes this option much easier to distribute than the VPP apps, for which you would need to purchase individual codes and distribute them between your users to allow them to download the app.

More info here: https://developer.apple.com/support/unlisted-app-distribution/

What do we need from you?

1. Create an Apple Developer account

Enrolling in the Apple Developer Program as an organization

As an employee at a company, nonprofit organization, joint venture, partnership, or government organization, follow these steps to enroll in the Apple Developer Program through the Apple Developer app on iPhone, iPad, or Mac. Note that as the person enrolling your organization in the Apple Developer Program, you must have the legal authority to bind your organization to legal agreements. You must be the organization’s owner/founder, executive team member, senior project lead, or an employee with legal authority granted to you by a senior employee. Before you begin, you’ll need:

  • An iPhone or an iPad with Touch ID, Face ID, or a passcode enabled, or a Mac with Touch ID or a password enabled. You must use the same device for the entire enrollment process.
  • An Apple ID with two-factor authentication turned on. Your Apple ID information must be valid and up to date — including, but not limited to, your first name (given name), last name (family name), address, phone number, trusted phone number, and trusted devices.
  • The latest version of the Apple Developer app installed on your device.
  • To sign in to iCloud on your device.

Start enrollment

  1. Launch the Apple Developer app on the device you want to use for enrollment.
  2. Tap or click the Account tab.
  3. Sign in with your Apple ID. This can be different than the Apple ID signed in to your device, but must have two-factor authentication turned on.
  4. If prompted, review the Apple Developer Agreement and tap or click Agree.
  5. Tap or click Enroll Now.
  6. Review the program benefits and requirements and tap or click Continue.

Enter your information as the Account Holder

  1. If requested, enter your legal first name, legal last name, and phone number. Do not enter an alias, nickname, or company name as your legal name, as doing so will cause a delay in the completion of your enrollment review.
  2. You’ll be asked to verify your identity using your driver’s license or government-issued photo ID. Capture your photo ID and tap or click Confirm. 

Enter your organization’s information

Follow the steps on the next few screens to provide the following information:

  • Entity type.
  • Legal entity name. DBAs, fictitious businesses, trade names, or branches are not allowed. The legal entity name will appear as the “seller” for apps you distribute. Example: Seller: ABC Company, Inc.
  • D‑U‑N‑S® Number. Your organization must have a D‑U‑N‑S Number so that its identity and legal entity status can be verified by Apple. These unique nine-digit numbers are assigned by Dun & Bradstreet and are widely used as standard business identifiers. You can look yours up and request one for free.
  • Headquarters address and phone number.
  • Website. Your organization’s website must be publicly available and the domain name must be associated with your organization.
  • Signing authority confirmation. Confirm that you have the authority to bind your organization to legal agreements and provide the contact information of an employee who can verify your signature authority.
  • Optionally, if your organization is a nonprofit, educational, or government organization, you can request a fee waiver.

After you’ve submitted your information, it will be reviewed by Apple. Once your information has been verified you will receive an email letting you know that you can complete your enrollment.

Complete enrollment and purchase

Once you have received the email, you can continue with the following steps:

  1. Launch the Apple Developer app on the device you used for enrollment.
  2. Tap or click the Account tab.
  3. Sign in with the Apple ID you used for enrollment.
  4. Tap or click Continue Your Enrollment.
  5. Review the terms of the Apple Developer Program License Agreement and tap or click Agree.
  6. Review your annual membership subscription details and tap or click the Subscribe button.

Membership is provided on an annual basis as an auto-renewable subscription that renews until canceled. You can make your purchase using one of your Apple ID payment methods. If you need to use your organization’s credit card, add it to the Apple ID that’s signed in to your device’s settings. This can be a different Apple ID than the one you use to enroll. A receipt will be emailed to you, and you can resend the receipt to yourself via email at any time from Purchase History in Settings. You can cancel your subscription in Settings up to one day before your annual renewal date. Membership fees paid for the year during which you cancel are nonrefundable.

Learn about managing your Apple ID payment methods


Verifying your identity

Identity verification in the app is required for certain processes, including those that are started and completed on the web (for example, accepting an Account Holder transfer or applying for the Apple Developer Enterprise Program). Once your identity has been verified, it’s associated with your Apple ID and can’t be verified again by signing in with other Apple IDs. Before you begin, you’ll need:

  • An iPhone or an iPad with Touch ID, Face ID, or a passcode enabled, or a Mac with Touch ID or a password enabled. You must use the same device for the entire enrollment process.
  • An Apple ID with two-factor authentication turned on. Your Apple ID information must be valid and up to date — including, but not limited to, your first name (given name), last name (family name), address, phone number, trusted phone number, and trusted devices.
  • The latest version of the Apple Developer app installed on your device.
  • To sign in to iCloud on your device.

Verify your identity

  1. Launch the Apple Developer app.
  2. Tap or click the Account tab.
  3. Sign in with your Apple ID associated with your application or Apple Developer account.
  4. Tap or click Verify Your Identity.
  5. If requested, enter your legal first name, legal last name, and phone number. Please do not enter an alias, nickname, or company name as your legal name, as doing so will cause a delay in verification.
  6. Capture your driver’s license or government-issued photo ID.
  7. Review the information you submitted and tap or click Continue.

Complete the process

When your identity has been verified, a confirmation screen will display. You can then return to the web to complete the process if needed.

2. Giving permissions to Speakap

Invite us to your Apple Account

Once your account is configured on your side, we need our user “mobile-development@speakap.nl” to be invited to your Apple Account. The easiest way is to give us the “Admin” role but if you are hesitant to give us such permissions, note that we need at least the "App Manager" role with "Access to Certificates, Identifiers & Profiles", and "Access to Cloud Managed Distribution Certificate permissions” to be able to manage the app in your account:

To be able to generate the app, we need that the Apple Developer account has less than 3 “already created” distribution certificates. If you have already 3 distribution certificates in your account you can share one of the already existing ones with us.

 

API key

To upload the app and its updates to your account we need the App Store Connect API Key. This can only be generated by the Apple account’s “Account Holder” user

  1. Log in to App Store Connect
  2. Select Users and Access, and then select the API Keys to generate API Key or the Add (+) button.
  3. Enter a name for the key. The name is for your reference only and is not part of the key itself.
  4. Under Access, select the role for the key. We recommend “Admin” as it will allow us to manage the app version upload and certificate renewal processes.
  5. Click Generate.
  6. Click on the Download API Key link next to the new API key.

 

This key can only be downloaded once!! Be sure to store it somewhere safe and accessible for you, and send it to us. We will store it safely too.

More information about how to generate the API key is here:

https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api 

 

3. Provide us the information for your app

We need all the necessary information to create and deploy your app regarding type of login, colors, name of your Apple account… your CSM will ask you for the information related to the app design.

Additionally, we need the following information about your Account:
Development Team Name and Development Team ID

You can find these values by logging to https://developer.apple.com/account/resources/certificates/list with your account and providing your CSM these values.

Screenshot 2024-08-15 at 16.01.49.png

Unlisted request

Once the app is ready to be published, we will send the app for review indicating to Apple’s reviewers that the app is intended to be distributed in their Unlisted program. Together with the app Apple will ask us to submit a form requesting the app to be included in their Unlisted program. Your CSM will provide you a form with these questions. Please fill this form and send it to your CSM, when Apple asks us to submit the Unlisted request we will provide your answers.

Please note that we only can submit this request for you if you gave us Admin rights in the account. If you gave us less permissions you will need to fill the Unlisted request via this link: https://developer.apple.com/contact/request/unlisted-app/ answering “Yes'' to “Have you submitted your app to the App Store for review?”, and we will need to synchronize to send the app and the request together. If the app and the request are not processed together by Apple the app would be automatically rejected.


Link to the document:

Unlisted App Request - For customers

4. .p8 for Apple Push Notifications (APNS)

An authenticated connection to APNs is required to send push notifications to an iOS app. There are two ways to provide this, either token-based (.p8) or certificate-based (.p12).


This is a step that we can perform if you give our mobile-development@speakap.nl the permissions that have been explained before. However, if you want to keep a local copy of the key, please perform the following steps and the forward the key to us.


Our recommendation is that you create a .p8 file and share it with us since the .p8 certificate doesn’t expire while the .p12 does expire. If you share with us this .p8 file we will upload it to ensure that your app has enabled push notifications. If you decide not to share the .p8 with us you can still have push notifications but you will need to create a .p12 certificate and refresh it when it expires (normally every year).

How to create the .p8

  1. Log in to your Apple Developer Account and navigate to Certificates, Identifiers & Profiles -> Keys and select the Blue + button.
  2. Select Apple Push Notifications service (APNs), and enter a name for the key.
  3. Select Continue and on the next page, select Register.
  4. Download your new key and save it in a secure place. You can only download it once, so don't lose it. 
  5. Click on “Done” and you will have a new key.
Was this article helpful?
0 out of 0 found this helpful