Files
baibot-withmcp/docs/configuration/authentication.md
Slavi Pantaleev 527759dd02 Document Matrix authentication modes
Add a dedicated configuration/authentication doc covering password and access-token setup,
including environment-variable mappings and token-generation example.

Link to it from configuration docs and align the sample config wording with Matrix Authentication Service/OIDC terminology.
2026-03-07 11:08:50 +02:00

767 B

🔐 Authentication

baibot supports 2 authentication modes for the Matrix account (user.* keys in config).

Set exactly one mode. If both are set (or neither is set), startup validation fails.

Password authentication

  • Config key: user.password
  • Environment variable: BAIBOT_USER_PASSWORD

Access token authentication

  • Config keys: user.access_token + user.device_id
  • Environment variables: BAIBOT_USER_ACCESS_TOKEN + BAIBOT_USER_DEVICE_ID

Access-token authentication is useful for OIDC-enabled homeservers (e.g. those using Matrix Authentication Service).

Example token-generation command:

mas-cli manage issue-compatibility-token <username> [device_id]