Copied to clipboard

Bypassing the passcode on iOS devices

During Manual Test sessions, if your iOS devices or applications require a passcode for security or any specific testing purpose, Kobiton will help you to automatically bypass the passcode (number only) and continue your test execution by following these steps:

Setup on supervised iOS local devices

Prerequisite

  • On the Mac machine: Download the latest version of Apple Configurator. We are using Apple Configurator version 2.11.1 (3K81) in this guide. Click here to download.

  • On the iOS devices: Remove iCloud account and Restriction mode if existing.

Step 1: Install cfgutil tools

  • Open the Apple Configurator 2 application
  • Click on Apple Configurator 2 title on the left top corner of the desktop screen
  • Select Install Automation Tools…

cfgutil.jpg

  • The popup “Install Automation Tools” is displayed, click on “Install” button

cfgutil_02.jpg

  • Enter “User Name” and “Password” (user login account) and click “Add Helper” button.

cfgutil_03.jpg

Step 2: Import an Organization

  • Firstly, you need to create an Organization with Apple Configurator 2. Please access here to set up your Organization (Supervision Identity) with the Apple official guideline.

  • Click on Apple Configurator 2 title on left top corner

  • Select “Preference”

  • Go to “Organizations” tab

kobi_org.png

  • Click on “Settings” button

  • Select “Import Organization...”

kobi_org_02.png

  • Select your Organization file and enter the password (if any)

Step 3: Export Supervision Identity

  • Click on Apple Configurator 2 title on left top corner
  • Select “Preference”
  • Select “Organizations” tab.
  • Select your Organization
  • Click on “Settings” button.
  • Select “Export Supervision Identity...”

new-supervision.png

  • Select Format Unencrypted DER (.crt and .der, for Automator and cfgutil)
  • Name as: “Organization.der”

supervision_02.png

  • Click on “Save” button
  • Then, the “Export for cfgutil” popup is displayed
  • Click on “Export” button

Step 4: Activate Supervised Mode for iOS

  • Attach your iOS device to the computer using the USB cable
  • In the “Unsupervised” view, right click on the iOS device
  • Select “Prepare”

supervised.png

  • Select Prepare with “Manual Configuration”
  • Check “Supervise devices” & “Allow devices to pair with other computers”

supervised_02.png

  • Click “Next” button
  • Select Server “Do not enroll in MDM”

supervised_03.png

  • Click “Next” button
  • Select your organization

supervised_04.png

  • Click “Next” button
  • Select Setup Assistant “Don’t show any of these steps”

supervised_05.png

  • Click “Prepare” button
  • If the confirm popup is displayed, click on “Erase” button

supervised_06.png

  • Wait for “Preparing” the device progress

supervised_07.png

  • fter the preparing finish, please setup the iOS device as new iPhone and sign in with Apple ID account to set up
  • Now the device is moved to “Supervised” tab

supervised_08.png

Step 5: Prepare data for “Unlock token"

  • Copy 2 files Organization .crt & Organization.der that generated on the step 3 to this folder: ~/Library/Application Support/Kobiton/
  • Plug the device to the Kobiton desktop
  • Access the folder ~/Library/Application Support/Kobiton/devices/{udid}* with *{udid} is the UDID of this device, then

token_02.jpg

  • Create a new TextEdit Document file with following structure and filename is data: (Replace “0000” with the passcode that you prefer)

    {
    “type”: “pin”,
    “key”: “0000”
    }
    
  • Unplug & plug device into the USB port again

  • Register the device and start your testing

Note

  • If the Kobiton desktop cannot detect the iOS device, turn the screen on (and enter the passcode the first time), then click Trust button on the device screen.

  • Sometimes the desktop could not recognize the device, we should close/re-open the desktop app again to trigger the device startup process.

Setup on supervised iOS cloud devices

For Kobiton cloud devices, please contact us via support@kobiton.com for the configuration, we will help you to setup and generate the token.

Feedback

SELECTED

Tip

You can select a specific word, line of text, or one or more paragraphs to comment.

COMMENT

Please give us some feedback !
Thank you!
  • We are listening,
  • we will do our best to fix this soon