The effective and efficient distribution of the Igloo Mobile Branded Edition application is key to the success of the project and acceptance by users.
This article provides an overview of the distribution option and the steps to set up the required artifacts Igloo requires to create branded mobile builds.
Sections in this article:
- Distribution options
- What we need from you
- iOS distribution
- Android distribution
- Setting up accounts for testing and validation
If you have any questions about the required information or the steps to obtain them, don't hesitate to contact your Igloo Project Manager for assistance.
Distribution options
There are 2 recommended methods that can be used to distribute your branded mobile app to members of your digital workplace. See the chart below to better understand which method is right for your organization.
MDM (Mobile Device Management) | App Store ( Private /Unlisted Distribution) |
---|---|
Mobile Device Management (MDM) is a set of technologies, processes, and policies used to manage and secure mobile devices, such as smartphones, tablets, and laptops, within an organization. MDM solutions enable IT administrators to remotely manage and control mobile devices, enforce security measures, and streamline device deployment and maintenance. Here are some key aspects of Mobile Device Management:
Igloo is not responsible for providing instructions for app deployment through MDM. Please contact your MDM provider for guidance and support. |
Private or unlisted app distribution provides a way to share apps with a specific audience while maintaining control, security, and flexibility outside the traditional public app store model. Here are some key aspects of private or unlisted app distribution:
See these additional resources for more information: |
In some cases, you might even combine both approaches. For example, you can use MDM to distribute internal apps within your organization while using App Store distribution for public-facing apps. Ultimately, the decision depends on your specific needs regarding control, target audience, security, and distribution requirements.
What we need from you
Regardless of the distribution method, Igloo requires third-party vendor support to allow the application to run on a smartphone. The requirements include:
- Provisioning information to use in the build process from Apple and Google
- Setting up accounts for internal testing and validation
The following iOS and Android sections outline what information Igloo requires to deploy the application and how to obtain that information.
iOS distribution
Getting ready
To set up iOS distribution, you require:
- Access to a Mac
- An Apple Enterprise Developer Account under the Apple Developer Enterprise Program. For more information, see Apple Developer Enterprise Program.
The account will enable the use of the Apple infrastructure to provision the iOS version of the application. Please note:
- There is an application process for the Apple Enterprise Developer Account that Apple manages
- There is an eligibility criteria for organizations accepted
- There may be a small annual charge to maintain
- Require legal authority to bind your company to the agreement with Apple
Obtaining an Apple Enterprise Developer Account is subject to review and scrutiny by Apple with no guarantee on turnaround time or acceptance.
As part of setting up the application, you must provide the Igloo Team with the following:
- Distribution Certificate
- APNs Certificate
- Provisioning Profiles
The Igloo Team uses this information for the iOS .ipa builds.
The iOS Distribution Certificate and the APNs certificate expire after one year. You will need to renew these before their expiry date and share this updated information with the Igloo team.
Creating a Distribution Certificate
By following the steps below, you should be able to provide the Igloo Team with:
- Distribution Certificate in .p12 format with a password
- Private Key and Password
Steps to create an iOS Distribution Certificate:
- Log in to the Apple Developer site.
- Select Certificates, IDs & Profiles.
- Select Certificates.
- Select + to create a new certificate.
- In the Software section, select iOS Distribution and then select Continue.
- Upload a Certificate Signing Request (CSR) and then select Continue. If you don't have one, you can create one using Keychain Access on your Mac.
- Select Download to download the certificate as a .cer file.
- Double-click the certificate that you downloaded to add it to Keychain Access.
- Open Keychain Access
- Right-click the certificate and select Export.
- Select the .p12 file type.
- (Optional) Enter a password.
- Select the arrow next to the certificate to expand its details.
- Right-click the Private Key and select Export.
- Select the .p12 file type.
- (Optional) Enter a password.
- Share the required information with the Igloo Team. An Igloo Project Manager will provide details on how to share this information.
Creating an Apple Push Notification service (APNs) Certificate
By following the steps below, you should be able to provide the Igloo Team with:
- APNs certificate in .p12 format with a password
The Igloo team uses this information to set up push notifications.
Steps to create an APNs Certificate:
- Log in to the Apple Developer site.
- Select Certificates, IDs & Profiles.
- Select Identifiers.
- Select + to create a new App ID.
- Enter a description and Bundle ID, e.g., com.igloosoftware.branded.mobile.{organization.name}.
- In the Capabilities section, select Push Notifications.
- Follow the steps on the page to finish creating a new APP ID.
- Go back to the Certificates, IDs & Profiles page.
- Select Certificates.
- Select + to create a new APNs certificate.
- In the Services section, select "Apple Push Notification service SSL (Sandbox & Production)."
- From the drop-down, select the App ID that you created.
- Upload a Certificate Signing Request (CSR). If you don't have one, you can create one using Keychain Access on your Mac.
- Finish creating the APNs certificate.
- Download the APNs certificate that you created.
- Double-click the APNs certificate that you downloaded to add it to Keychain Access.
- In Keychain Access, right-click the APNS certificate and select Export.
- Select the .p12 file type.
- Enter a password.
- Share the required information with the Igloo Team. An Igloo Project Manager will provide details on how to share this information.
Creating Provisioning Profiles
By following the steps below, you should be able to provide the Igloo Team with:
- The following Provisioning Profiles for MDM Distribution:
- {your_app_name} - In-House
- {your_app_name} - Ad Hoc
- {your_app_name} Share - In-House
- {your_app_name} Share - Ad Hoc
The Provisioning Profiles will use the iOS Distribution Certificate and App ID as described in the previous section. You must then create additional Provisioning Profiles of the same types on a separate App ID.
The Igloo Team uses this information for signing and distributing iOS .ipa builds.
Steps to create iOS Provisioning Profiles for MDM distribution:
- Log in to the Apple Developer site.
- Select Certificates, IDs & Profiles.
- Select Profiles.
- Select +to create a new In-House Provisioning Profile.
- In the Distribution section, select In-House and then select Continue.
- Select your App ID from the drop-down and then select Continue. Use the App ID that you created in the Creating an APNs Certificate section above.
- Select your iOS Distribution Certificate and then select Continue. Use the certificate that you created in the Creating a Distribution Certificate section above.
- Enter a name for the Provisioning Profile (e.g., {your_app_name} - In-House) and then select Generate.
- Select Download.
- Go back to the Certificates, Identifiers & Profiles page.
- Select + to create a new Ad Hoc Provisioning Profile.
- In the Distribution section, select Ad Hoc and then select Continue.
- Select your App ID from the drop-down and then select Continue. Use the App ID that you created in the Creating an APNs Certificate section above.
- Select your iOS Distribution Certificate and then select Continue. Use the certificate that you created in the Creating a Distribution Certificate section above.
- Select the following Igloo testing devices UDIDs and then select Continue.
- c6ba315377a9b4682bb839dda78458497d08942e
- 8f948c292cb2932a752755d12bd936e56804baf6
- Enter a name for the Provisioning Profile (e.g., {your_app_name} - Ad Hoc) and then select Generate.
- Select Download.
- Go back to the Certificates, Identifiers & Profiles page.
- Select + to create a new App ID.
- Enter a description and Bundle ID, e.g., com.igloosoftware.branded.mobile.{organization.name}.share.
- Follow the steps on the page to finish creating a new APP ID.
- Go back to the Certificates, Identifiers & Profiles page.
- Select + to create a new In-House Provisioning Profile.
- In the Distribution section, select In-House and then select Continue.
- Select the App ID that you created in step 8 from the drop-down and then select Continue.
- Select your iOS Distribution Certificate and then select Continue. Use the certificate that you created in the Creating a Distribution Certificate section above.
- Enter a name for the Provisioning Profile (e.g., {your_app_name} Share - In-House) and then select Generate.
- Select Download.
- Go back to the Certificates, Identifiers & Profiles page.
- Select + to create a new Ad Hoc Provisioning Profile.
- In the Distribution section, select Ad Hoc and then select Continue.
- Select the App ID that you created in step 8 from the drop-down and then select Continue.
- Select your iOS Distribution Certificate and then select Continue. Use the certificate that you created in the Creating a Distribution Certificate section above.
- Select the following Igloo testing devices UDIDs and then select Continue.
- c6ba315377a9b4682bb839dda78458497d08942e
- 8f948c292cb2932a752755d12bd936e56804baf6
- Enter a name for the Provisioning Profile (e.g., {your_app_name} Share - Ad Hoc) and then select Generate.
- Select Download.
- Share the required information with the Igloo Team. An Igloo Project Manager will provide details on how to share this information.
Checklist of the required information to share with Igloo
- Distribution Certificate in .p12 format with a password
- Distribution Certificate private key and password
- APNs certificate in .p12 format with a password
-
The following Provisioning Profiles:
- {your_app_name} - In-House
- {your_app_name} - Ad Hoc
- {your_app_name} Share - In-House
- {your_app_name} Share - Ad Hoc
Android distribution
Getting ready
To set up Android distribution, you require:
- A Google Play Store account
- Access to your organization's Google Firebase Console account
There may be a low, one-time fee to set up the account. For more information, see Google Play Console (About) and Google Play Console (Signup).
As part of setting up the application, you must provide the Igloo Team with the following:
- Firebase Cloud Messaging (FCM) details
The Igloo team uses this information to set up push notifications.
Setting up Firebase Cloud Messaging (FCM)
By following the steps below, you should be able to provide the Igloo Team with:
- google-services.json file
- Cloud Messaging API Server Key
Steps to set up FCM:
- Log in to Google Firebase Console.
- Select + Add project.
- Enter a project name and then select Continue.
- Select whether Google Analytics is enabled or disabled.
- If you selected to enable, select Continue. Select the Google Analytics account to use, and then select Create Project.
- If you selected to disable, select Create Project.
- Select your newly created project.
- Select the Android icon.
- Enter an app package name, e.g., com.igloosoftware.branded.mobile.{organization.name}.
- (Optional) Enter an App nickname.
- (Optional) Enter a debug signing certificate SHA-1.
- Select Register app.
- On the next screen, it gives you a chance to download google-service.json file which will be needed by Igloo Team. Select Download google-service.json.
- Select Next.
- For Step 3, select Next. The Igloo Mobile Team will be responsible for adding the Firebase SDK.
- For Step 4, select Continue to console. You will be redirected to the Project Overview screen of the app you just created.
- On the left menu bar under Build, select Authentication. You don't need to enable any authentication, but this step helps to complete some hidden configurations.
- Select Get Started.
- Select the Users tab.
</li
- Your screen should resemble the picture below. Do nothing on this screen and proceed to the next step.
- Select the cog next to Project Overview, followed by Project settings.
- Select the Cloud Messaging tab.
- Next to the Cloud Messaging API (Legacy) Disabled heading, there is a 3-dot button; select it and then select Manage API in Google Cloud Console.
- Select Enable.
- Once GCM (Google Cloud Messaging) service is enabled, you should see a page that resembles the below image. Go back to the Cloud Messaging tab in your Firebase project.
- You should be seeing that Cloud Messaging API (Legacy) is now enabled and the Server key has been generated.
- Copy this Server Key and save it to the text file for sharing with the Igloo Team at the end of this process.
- Select the General tab.
- Scroll down the page and from Your Apps section, select the app that you just created.
- If you didn't download the google-services.json file in step 11, select google-service.json to download it.
- Share the google-services.json and Server Key (saved in Step-25) with the Igloo Team. An Igloo Project Manager will provide details on how to share this information.
Checklist of the required information to share with Igloo
- google-services.json file
- Cloud Messaging API Server Key
Setting up accounts for internal testing and validation
You must set up two user accounts in your digital workplace so that Igloo can test and support Igloo Mobile Branded Edition. These accounts should have the following attributes:
- Account 1
- First name: Test
- Last name: IglooMobil1
- Email: prem_mobile_1@igloosoftware.com
- Account 2
- First name: Test
- Last name: IglooMobil2
- Email: prem_mobile_2@igloosoftware.com