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…

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

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

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

• Click on “Settings” button

• Select “Import Organization...”

• 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...”

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

• 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”

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

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

• Click “Next” button
• Select your organization

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

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

• Wait for “Preparing” the device progress

• 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

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

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