Skip to content

Log in using a token

Jump to bottom
Fidel Perez-Smith edited this page Aug 13, 2025 · 2 revisions

condeco-cli supports logging in with a token. The following steps describe how to acquire a token using an Android Emulator.

Create an Android Virtual Device

  1. On the PC, Install Android Studio
  2. Run Android Studio, More Actions → Virtual Device Manager
  3. Create a new device (any modern one without Google Play, because that makes it difficult to inspect traffic)
  4. Start the device

Enable Developer Mode

  1. On the Android device, open Settings → About emulated device
  2. Find the Build number. Tap it seven times quickly.
  3. It should say "You are now a developer!"

Enable USB debugging

  1. System → Developer options → USB debugging → on

Download the Engage app

  1. On the PC, download the app from: https://apkpure.com/eptura-engage/com.condecosoftware.condeco
  2. If it's an apkx, extract it using 7-Zip to C:\Temp\engage

Instruct the Android device to install the app

  1. cd "C:\Program Files (x86)\Android\android-sdk\platform-tools" or cd "C:\users\[username]\AppData\Local\Android\Sdk\platform tools"
  2. .\adb.exe install-multiple "C:\Temp\engage\com.condecosoftware.condeco.apk" "C:\Temp\engage\config.arm64_v8a.apk" "C:\Temp\engage\config.en.apk" "C:\Temp\engage\config.mdpi.apk"
  3. Confirm the app is now installed on the Android device

Install HTTP Toolkit to inspect traffic

  1. On the PC, download and install HTTP Tool kit from: https://httptoolkit.com/
  2. Run HTTP Toolkit and click Android Device via ADB
  3. On the Android device, it should now say 'Connected'
  4. On the PC, in HTTP Toolkit on the left side click 'View'
  5. Confirm some web requests are displayed

Collect the token

  1. On the Android device, log into Engage
  2. In HTTP Toolkit, find the POST request to LoginAPI/auth/authenticateusersecure
  3. On the right, scroll down to the Response Body.
  4. The token should be listed, in GUID form such as F0029539-6EAA-44C0-B35A-D6C525C63BAA

Use the token in condeco-cli

  1. Run condeco in mobile mode, using condeco-cli.exe --api mobile
  2. You can now add your service and choose 'Log in using token'
Clone this wiki locally