iOS Device Settings

Before going through the process of configuring iOS devices to run on GigaFox, go through the following settings adjustments.

NOTE: The specific path to access a feature's settings may vary depending on the device's iOS version.

'Trust This Computer' Alert

All iOS devices must "trust" the computer to which they are connected. To "trust" the communication between the computer and device:

  1. Plug device into the computer.
  2. On the physical device, click Trust on the Trust this Computer? alert.

Reduce Screen Brightness

To reduce battery usage without affecting the display:

  1. Open Settings > General > Accessibility Display Accommodations.
  2. Scroll to Auto-Brightness and toggle Off.
  3. Slide the brightness slider to the lowest setting.

Enable UI Automation

Beginning with iOS 8, devices must enable UI Automation.

To enable UI Automation:

  1. Connect device and launch Xcode.
  2. On the device, open Settings > Developer.
  3. Toggle on Enable UI Automation.

NOTE: The Developer settings option will also be available when a device connects to deviceControl.

iOS Provisioning Profile

The provisioning profile is a collection of digital components that uniquely identify and tie developers and devices to an authorized Development Team, enabling a device to be used for testing, or in this case, be provisioned to connect to GigaFox.

This tutorial assumes you are enrolled in the Apple Developer Program and your assigned role includes the ability to create a provisioning profile.

Register iOS Devices

For Apple to allow the distribution of an app, each physical iOS device the app will be tested on must be registered with Apple's Developer Program.

  1. Retrieve the device's UDID.
    1. Connect the device to an Apple computer and open iTunes.
    2. On the top left, click the mobile device icon.
    3. The device's UDID is located in the device's details box. If the UDID is not immediately displayed, click on the device's ID line (under Capacity) until it displays the UDID. You may see Model Identifier, Serial Number, and ECID before getting to the device's UDID.
    UDID on iTunes
  2. To register one or more devices:
    1. Log into your developer.apple.com account and click on Certificates, Identifiers & Profiles.
    2. Confirm the iOS Certificate page dropdown menu option is on iOS, tvOS, watchOS.
    3. Under Devices, click All or the specific type of device to register (i.e. iPod Touch).
    4. On the top right, click the + (plus) sign.
    5. If registering a single device, under Register a Device, enter a Name and the device's UDID and click Continue.
    6. If registering multiple devices, under Register Multiple Devices page, upload a file with the Devices ID and Name and click Continue.
      7. List of registering multiple devices
    7. On the Review and Register page, confirm the information is correct and click Register.

    A Registration complete dialog will display if the device(s) was properly registered.

    Create an App ID

    Apple's App ID is a two-part string, a Team ID and Bundle ID, which identifies one or more applications from a single application development team. For example, 123ABC456XYZ.com.companyname.appname.

    • Team ID: 123ABC456XYZ.
    • Bundle ID: com.companyname.appname

    To create an App ID (if a suitable one does not yet exist):

    1. Log into developer.apple.com account.
    2. Under Identifiers, select App IDs.
    3. On the top right, click the + button.
    4. On the Registering an App ID page:
      1. Under App ID Description, enter the App ID description name.
      2. App ID Prefix will display the Team ID.
      3. Under App ID Suffix, fill in Explicit App ID or Wildcard App ID. Any of the following are acceptable IDs:
        • mobilelabsinc.deviceControl
        • *
        • com.mobilelabsinc.*
      4. In the App Services section, enable the necessary services for the App and click Continue.
      5. To complete the registration, in the Confirm your App ID page, review the information. If the app's information is correct and click Register.

    The newly created App ID will now be listed on the Apple Developer account under Identifiers > App IDs.

    Create a Developer Certificate

    The certificate is a public/private key pair identifier. This identifier is needed to assure that the right user or team has access to the application.

    Developer certificates can be created through Xcode or the Apple Developer account. Both options are listed below.

    To create an iOS Developer Certificate through Xcode:

    1. Open Xcode.
    2. Click on the Xcode dropdown menu, select Preferences.
    3. Click Accounts.
      4. Xcode Accounts dialog
    4. On the Sign in with your App ID dialog, sign in and click Sign In.
    5. On the bottom left of the Apple ID column, click the + (plus) button.
    6. On the Select which type of account you want to create dialog, select Apple ID and click Continue.
    7. Click on Manage Certificates.
    8. On the Signing certificates for "Company Name", click the + (plus) button and select iOS Development. The iOS Development Certificate will be created and added to the Development list on the Apple Developer Certificates page.
    9. The certificate will automatically be loaded into the Keychain Access app. To confirm, click login and check that the iPhone Developer:Name(Certificate Number) is present.

    To create an iOS Development Certificate through the Apple Developer Account:

    1. Log into your developer.apple.com account and click on Certificates, Identifiers & Profiles.
    2. Under Certificates, Identifiers & Profiles, set the dropdown menu to be iOS, tvOS, watchOS.
    3. Under Certificates, select Development.
    4. On the top right, click the + (plus) button.
    5. On the What Type of certificate do you need page, select iOS App Development, scroll down, and click Continue.
    6. If you have already created the Certificate Signing Request (CSR), click Continue. Otherwise, follow the steps to create it.
    7. On the Generate your certificate page, click Choose File to upload the CSR.
    8. Click Continue.
    9. On the Your certificate is ready page, click Download. The certificate will be located in the iOS Certificates (Development) list.
    10. The certificate will automatically be loaded into the Keychain Access app. To confirm, click login and check that the iPhone Developer:Name(Certificate Number) is present.

    Once the certificate is created, through Xcode or the Apple Developer Program verify:

    1. A small green circle with a check mark followed by This certificate is valid is listed among the certificate's details.
    2. A disclosure triangle is present to the left of the certificate. If the triangle is not visible, the private key is missing.

    After the provisioning profile and certificate has been uploaded to GigaFox, common issues will be detected and clear messaging will describe the issue.

    Create .p12 Certificate

    1. Open Keychain Access.
    2. On the bottom left, click Certificates.
    3. Expand the certificate information and highlight both the certificate and private key.
    4. With both highlighted, right click and select Export 2 items.
      • Name the certificate.
      • Add tags (optional).
      • Select where the certificate will be saved.
      • In the Password dialog, enter a password, verify it and click OK.
    5. Back in Keychain Access, add the .p12 file to System > My Certificates section. This step may ask for login information.
    6. In the Keychain Access wants to Export "access" from Keychain dialog, select Allow.

    Adjust Keychain Access Settings

    1. Open Keychain Settings.
    2. Confirm that your certificate is located in System > My Certificates. If it's located in another section of the Keychain:
      1. Highlight the certificate.
      2. Drag the certificate to System.
      3. Select Allow on the kcproxy want to export key "access" from your keychain dialog.
    3. Double-click the private key to access the Attributes/Access Control dialog.
    4. In Access Control, select Allow all applications to access this item and click Save Changes.

    Create A Provisioning Profile

    1. Log into developer.apple.com account.
    2. Select Certificates, Identifiers & Profiles
    3. Under Provisioning Profiles select Development.
    4. On the iOS Provisioning Profiles (Development), on the top right, click the + button.
    5. In the What type of provisioning profile do you need?, select iOS App Development
    6. In the Development section, select iOS Development and click Continue.
    7. Select the App ID you created earlier and click Continue.
    8. On the Select certificates page, enable the Select All option and click Continue.
    9. On the Select devices page, enable the Select All option and click Continue.
    10. In the Name this profile and generate page, give the Profile a name and click Continue.
    11. Download and save the Provisioning Profile.
    12. Click Done.

    Install the Provisioning Profile and Certificate on GigaFox

    1. Open GigaFox.
    2. Navigate to Systems > iOS Management.
    3. Scroll down to iOS Provisioning Status, under Upload provisioning profile, click Choose File.
    4. Once the profile is uploaded, the device will be provisioned and ready to be connected through GigaFox.

    Provisioning Profile and Certificate Error Messaging

    If after uploading the certificate and profile, the device(s) associated with the profile are not provisioned, clear error messaging will indicate if the issue(s) stems from the certificate and/or the provisioning profile.
    Error messages will be located in the iOS Provisioning Status  section, either under Installed provisioning profiles or  Available signing certificates.


    The following is a list of GigaFox error messages and how to troubleshoot the issue:

    • Restricted access to private key: Failed: Available signing certificate not valid. An associated private key has restricted access.
      To allow private key access :
      1. Open Keychain Access.
      2. Under System > My Certificates, right-click on the private key.
      3. Under Access Control, select Allow all applications to access this item.
      4. Click Save Changes.
      5. If prompted, enter your computer's login password to modify the System Keychain.
    • Expired Certificate: Failed: Certificate is expired.
      To upload a valid certificate:
      1. Open Keychain Access and navigate the the iPhone Developer certificate associated with your provisioning profile.
      2. Click the disclosure triangle to reveal the its certificate.
      3. Highlight the certificate and private key, right-click and select the delete option or hit delete on your keyboard.
      4. If prompted, enter your computer's login password to modify the System Keychain.
      5. Follow the steps to create an iOS Developer Certificate.
      6. Go to developer.apple.com, click on Provisioning Profile, navigate the profile with the expired certificate, and select Edit.
      7. On the Edit iOS Provisioning Profiles (Development), in the Certificates section, Select All, and click Generate.
      8. Go back the Provisioning Profiles, select the profile and click Download.
      9. Follow the steps to upload the certificate and profile to GigaFox.
    • Missing Certificate: Failed: No signing certificate available.
      To add a certificate to the profile:
      1. If a certificate has not already been created, follow the steps to create an iOS Developer Certificate.
      2. If a certificate has been created, on the developer.apple.com account, go to Provisioning Profiles > Development, click on the profile and click Edit.
      3. On the Edit iOS Provisioning Profiles (Development), in the Certificates section, Select All, and click Generate.
      4. On the Your provisioning profile is ready page, click Download.
      5. Follow the steps to upload the certificate and profile to GigaFox.
    • Expired Provisioning Profile: Failed: Profile expired (expiration date).
      • To renew an expired profile:
      1. Go to developer.apple.com, under Provisioning Profiles > go to All or Development, select the expired profile and click Edit.
      2. On the Edit iOS Provisioning Profiles (Development) Scroll to the bottom, then click Generate.
      3. Follow the steps to upload the certificate and profile to GigaFox.

    iOS Provisioning Tool

    The process outlined above is the intended method to provision iOS devices. If an error occurs and the certificate/private key are unable to load onto the GigaFox GEM, the iOS Provisioning Tool can be used to complete the provisioning process as long as the profile components have been created and are available through Xcode.

    iOS Provisioning Status

    On the System > iOS Management page, the provisioning status for each iOS device will be displayed iOS Provisioning Status > Devices. Devices that have been properly provisioned will display checkmarks for deviceControl and Provisioning Profile.