Configure the local server for network payload capture

Learn how to configure your local Cloud or Standalone Kobiton server so you and your team can use network payload capture during a manual session or automation session.

Before you start

You’ll need to:

  • Verify your system administrator privileges for the local Cloud or Standalone Kobiton server.

  • Download and install Apple Configurator on the server.

Get the local server IP address

You can use the ifoncifg command to get your server’s IP address from en0. Open the terminal, the use the following command to copy the IP address to your clipboard using the following command. Save this value in a secure location for later.

ifconfig en0 | grep ether | awk '{print $2}' | pbcopy

Modify the dc.ini file

Next, you’ll edit the dc.ini within the deviceconnect directory. Open the file in your preferred text editor.

Example
nano ~/usr/local/deviceconnect/dc.ini

If the following lines are present, simply verify the IP address, then go to Check for an existing SSH key. Otherwise, add these lines to the end of the file and replace LOCAL_SERVER_IP_ADDRESS with the correct value.

# Payload Capture
DeviceNetworkCapture.NetworkCaptureProxyHost=LOCAL_SERVER_IP_ADDRESS
DeviceNetworkCapture.NetworkCaptureProxyIsLocal=true
DeviceNetworkCapture.NetworkCaptureProxyControlPort=8225
DeviceNetworkCapture.NetworkCaptureProxyHttpListenPort=8080
DeviceNetworkCapture.TimeoutConnectSeconds=10
DeviceNetworkCapture.Trace=true
DeviceNetworkCapture.ExternalDebugLog=false

When you’re finished, save your changes, then run the following command to restart deviceConnect.

sudo sv restart /usr/local/var/service/*

Check for an existing SSH key

In the terminal, open the .ssh directory, then list the contents of the directory.

cd ~/.ssh && ls -a

If you see an id_rsa file, go to Modify the SSH key. Otherwise, continue to the next section.

Generate a new SSH key

In the .ssh directory, enter the following command:

ssh-keygen -t rsa

Leave the passphrase empty and press Enter.

> Enter passphrase (empty for no passphrase): [Leave empty]
> Enter same passphrase again: [Leave empty]

Now you’re ready to modify the SSH key.

Modify the SSH key

In the .ssh directory, copy the contents from your id_rsa public key into the authorized_keys_ file.

cat id_rsa.pub >> ./authorized_keys
If an authorized_keys_ file doesn’t exist, one will be automatically created.

Login using your SSH key. If prompted to trust this connection, type yes and press Enter.

ssh 127.0.0.1

After you’re successfully logged in, exit the SSH session, then restart the macMini.

exit && sudo shutdown -r now

Set up Apple Configurator

Open the Apple Configurator app you installed previously.

In the menu bar, select Apple Configurator 2, then select Install Automation Tools:

Select Install, then enter your admin password. Once the automation tools are installed, you can close Apple Configurator since it doesn’t need to be open for network payload capture.

Now, you can configure your Android device or iOS device for network payload capture.