This documentation supports the 2.0 version of Remedy with Smart IT.

To view the latest 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:

    MYIT_HOME\Smart_IT_MyIT\IPA\download\utils directory, where MYIT_HOME is the installation directory.

    If you are using Smart IT versions prior to 1.6, you can obtain the utility from BMC Communities.
  • 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.


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:

VisitDetails
Apple Enterprise Program application
  • 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.
Apple Developer portalProvides development tools, and documentation needed to develop Apple iOS apps.
Managing your teamDescribes how to assign the team agent role to the user who is going to re-sign Smart IT.
Accessing Member Center and iTunes ConnectProvides 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.

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

    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 IT within the iOS Provisioning portal (for example, Calbro Smart IT).
      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.SmartIT).
      Make a note of the bundle ID for the re-signing process.
    4. Go to the App Services section, and select Push NotificationsiCloud, and App Group. For iCloud, select the option Include CloudKit support (requires Xcode 6).
    5. Click Continue.
    6. Click Done.

      The Identifiers list is displayed.

    To create an Application ID and Bundle ID for Apple Watch identifier:

    1. Go to the App IDs tab, and click the plus sign (+) to add a new Apple Watch identifier.
    2. In the Description field, type a name to identify Smart IT within the iOS Provisioning portal. For example, Calbro Smart IT Watch.

    3. Select Explicit App ID, and enter a unique identifier in the Bundle ID field. This identifier must be prefixed with the identifier of the iPhone application for example, com.companyName.SmartIT.watch.

    4. Go to the App Services section, and select the App Group option.

    5. Click Continue.

    6. Click Submit.

      The Identifiers list is displayed.

    To create an Application ID and Bundle ID for Apple Watch identifier:

    1. Go to the App IDs tab, and click the plus sign (+) to add a new Apple Watch Extension identifier.
    2. In the Description field, type a name to identify Smart IT within the iOS Provisioning portal. For example, Calbro Smart IT Watch Extension.
    3. Select Explicit App ID, and enter a unique identifier in the Bundle ID field. This identifier must be prefixed with the identifier of your Apple watch identifier, for example, com.companyName.SmartIT.watch.extension.
    4. Go to the App Services section, and select the App Group option.
    5. Click Continue.
    6. Click Submit.
      The Identifiers list is displayed.

    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

      To generate the Enterprise Distribution certificate:

      1. In the Certificates section, click the plus sign (+) to add the certificate.

      2. In the Production sub-section, select In-House and Ad Hoc and click Continue.
      3. Follow the instructions provided by Certificate Assistant to generate a Certificate Signing Request (CSR).
      4. Upload the CSR on the iOS Provisioning Portal.
        The ED certificate is generated on the Apple site.
      5. Download the ED certificate.
      6. Save the certificate on your Mac, and double-click the certificate file to install it in the login section of Keychain Access.

      To share the ED certificate with your team members (of the team agent or admin), or to move the certificate to another Mac machine, you must export the ED certificate. If you are re-signing on the same Mac machine with same login, then you need not share the certificate. However, if you are re-signing on different Mac machine, then you must export the certificate. To do so, follow these steps:

      1. In the login section of Keychain Access, go to the My Certificates section. 
      2. Right-click the ED certificate, and click Export.
      3. (Optional) Rename the certificate file name.
      4. Save the certificate in .p12 format.
        A window is displayed to protect the .p12 file.
      5. Provide a password and verify it.
        The ED certificate is exported.

      To verify if the .p12 ED certificate file is exported, or to import the .p12 certificate file, follow these steps:

      1. Double click the exported .p12 file.
      2. Select Login Keychain.
      3. Click Add.
      4. Enter the password.
        The ED certificate is available in the My Certificate section of the Login Keychain.

      To generate the APNS certificate:

      1. Go to the Production tab, and click the plus sign (+) to generate the certificate.
      2. Select Apple Push Notification Service SSL (Production).
      3. Select the App Prefix ID (Team ID) that you created.
      4. Follow the instructions that Apple has provided to generate a Certificate Signing Request (CSR) by using the Certificate Assistant. 
      5. Double-click the certificate to download and import it into your Keychain.

      In a later procedure, you must replace the Smart IT APNS certificate with your new APNS certificate.

      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.

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

        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.SmartIT.

          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 create a provisioning profile for Apple Watch:

        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.SmartIT.watch.

          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 create a provisioning profile for Apple Watch Extension:

        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.SmartIT.watch.extension.

          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.


        Note

        Place the provisioning profiles that you created into a folder, and rename the files to SmartIT.mobileprovision, SmartITWatch.mobileprovision, and SmartITWatchExtension.mobileprovision.

        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


         

        Was this page helpful? Yes No Submitting... Thank you

        Comments