This documentation supports the 21.05 version of BMC Helix ITSM: Smart IT.To view an earlier version, select the version from the Product version menu.

Preparing to re-sign and rebrand Smart IT on Apple iOS

Before you re-sign Smart IT on iOS devices, you must ensure that you meet all the prerequisites that are explained in this topic. 

Before you begin

  • You must have Apple Macintosh OS X El Capitan 10.11 or later to run the iOS re-signing and rebranding utility.
  • Use the utility to re-sign and rebrand Smart IT. This utility is available at the following location:
    Smart_IT\IPA\download\utils directory
  • From the App Store of Mac OS X, download and install Xcode version 8.2.1 or later, and its corresponding Xcode Command Line Tool on your Mac machine. Note that installing Xcode is a one-time activity.
  • You must have the Team Agent or Admin role. See Managing your team.

Related topic

Deploying-Smart-IT-to-your-users


Prerequisites for the Apple Enterprise Program

Your company must be a member of the Apple Enterprise Program to obtain the required development tools from the Apple Developer Portal. See the following resources for more information:

Visit

Details

  • Only a company or an organization with a D-U-N-S number can apply for the enterprise program.
  • An enterprise account allows you to distribute the rebranded application internally among your users.
  • An organization account enables you to distribute applications only through the Apple store.

Provides development tools, and documentation needed to develop Apple iOS apps.

Describes how to assign the team agent role to the user who is going to re-sign Smart IT.

Provides information about the necessary certificates and provisioning profiles.

To download the Apple Inc root certificate

The Apple root certificate is the primary certificate that helps to generate other Apple certificates that are needed to re-sign. It is available on Apple's site. You must download and install it in Keychain Access.

  1. Go to http://www.apple.com/certificateauthority/.
  2. Download the Apple Inc. Root Certificate.
  3. Double-click the certificate file to install it in the login section of Keychain Access.

To create an App group for Smart IT

In the Identifiers section of the iOS Provisioning portal, you must create an App group.

  1. Go to the App Groups tab, and click the plus sign (+) to add a new identifier.
  2. In the Description field, type a name to identify Smart IT within the iOS Provisioning portal. 
    For example, Calbro Smart IT Group.
  3. In the ID field, enter a unique group name. 
    For example, group.com.companyName.SmartIT.
  4. Click Continue.
  5. Click Register.
    The new App Group is created.

To create an iCloud container for Smart IT

In the Identifiers section of the iOS Provisioning portal, you must create an iCloud container.

  1. Go to the iCloud Containers tab, and click the plus sign (+) to add a new identifier.
  2. In the Description field, type a name to identify Smart IT within the iOS Provisioning portal. 
    For example, Smart IT iCloud Container.
  3. In the ID field, enter a unique group name. 
    For example, iCloud.com.companyName.SmartIT.
  4. Click Continue.
    The iCloud container is created.

To create an application ID and bundle ID for Smart IT

You must create an application ID and bundle ID to create an in-house distribution provisioning profile. If you have previously re-signed Smart IT on iOS, then you can use the existing application ID.

If App group and iCloud container is not added to the application ID, you must edit your existing application ID and add it. To do so, see the section Updating your existing application ID.

Invalid macro parameters used for the [tab-group] macro. Cause: [Unable to convert value [horizontal]. Allowed values are (case insensitive) "NONE" or "FADE".]. Click on this message for details.

To create an application ID and bundle ID for Smart Reporting

To create an application ID and bundle ID for your version of Smart Reporting:

  1. Go to the App IDs tab, and click the plus sign (+) to add a new identifier.
  2. In the Description field, type a name to identify Smart Reporting within the iOS Provisioning portal (for example, Calbro Smart Reporting).
    Make a note of the app ID prefix (team ID) for the re-signing process. 
  3. Select Explicit App ID, and enter a unique identifier in the Bundle ID field (for example, com.companyName.SmartReporting).
    Make a note of the bundle ID for the re-signing process.
  4. Click Continue.

  5. Click Done.

    The Identifiers list is displayed.

To generate the Enterprise Distribution and APNS certificate

In the iOS Provisioning portal at https://developer.apple.com/account/ios/certificate, generate the following certificates in the Certificates section:

  • The Enterprise Distribution (ED) certificate
  • The Apple Push Notification Service (APNS) certificate

Invalid macro parameters used for the [tab-group] macro. Cause: [Unable to convert value [horizontal]. Allowed values are (case insensitive) "NONE" or "FADE".]. Click on this message for details.

To create a Provisioning profile for Smart IT

You must create the provisioning profile to build the application to distribute the Smart IT on iOS to your employees. If you already have a provisioning profile created for an older version of Smart IT, you must edit that profile to pick up the new App Groups Service.

Invalid macro parameters used for the [tab-group] macro. Cause: [Unable to convert value [horizontal]. Allowed values are (case insensitive) "NONE" or "FADE".]. Click on this message for details.

To create a Provisioning profile for Smart Reporting

To create a provisioning profile for your version of Smart Reporting:

In the Profiles section, perform these steps:

  1. Click the plus sign (+) to add a new profile.
    The Register a New Provisioning Profile page is displayed.
  2. Specify the following details on the Register a New Provisioning Profile page:
    1. Under Distribution, select In House.
    2. Click Continue.
    3. Select the App ID that you created for example, com.companyName.SmartReporting.
    4. Click Continue.
    5. Select the distribution certificate that you created.
    6. Click Continue.
    7. Mention the Provisioning Profile Name.
    8. Review the App ID, and the Type.
    9. Click Generate.
  3. Download the provisioning profile.

To update your existing application ID

You must follow these steps to update your existing application ID.

  1. In the iOS Provisioning Portal, go to the Identifiers section, click the App IDs tab.
  2. Select your Smart IT application ID (for example, com.companyName.SmartIT)
  3. Click Edit.
  4. Click the select box next to App Groups.
  5. Click OK when prompted to enable app groups.
  6. Click Edit.
  7. Select the App Group created for Smart IT (for example, group.com.companyName.SmartIT).
  8. Click Continue > Assign > Done.
  9. Repeat steps 1 – 8 for the Apple Watch ID and Apple Watch Extension ID (for example, com.companyName.SmartIT.watch and com.companyName.SmartIT.watch.extension).
  10. Click Edit next to the iCloud option. 
  11. Select the iCloud container that you created (for example, iCloud.com.companyName.SmartIT)
  12. Click Continue > Assign > Done.

Where to go from here

Re-signing-Smart-IT-on-Apple-iOS

Rebranding-Smart-IT-on-Apple-iOS

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*