Wildix Authentication

Authenticates users with Wildix apps (Collaboration 7, x-bees, x-hoppers) via AWS Cognito CUSTOM_AUTH. Tokens stored per-email in <BASE_DIR>/tokens/.

Which Token to Use

Use IdToken for all Wildix API calls (not AccessToken). Expires in 1 hour.

Always retrieve it via get-token.sh — auto-refreshes when expired, validates via API after refresh:

ID_TOKEN=$(bash <BASE_DIR>/scripts/get-token.sh "<email>" "<BASE_DIR>")

Exit code 2 = token rejected by API → go to Mode 2 (re-auth).

Mode 1: Get a Valid Token (tokens already exist)