Bypass the passcode on iOS devices guidelines

Devices or applications that are encountered the 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.