Security Guide
Authentication and SSO
TheChatApp supports local credentials, secure sessions, OIDC SSO, admin roles, progressive lockout, and identity-provider driven role assignment.
Local authentication
Local users authenticate with username/password credentials. Passwords are hashed before storage, and administrative access is controlled separately from normal workspace membership.
Session tokens
User sessions use random tokens that are stored as hashes rather than plaintext. Tokens can be rotated, revoked, and limited across multiple signed-in devices.
OIDC SSO
OIDC SSO supports providers such as Microsoft Entra ID, Okta, and Google. TheChatApp validates signed identity tokens and can apply identity-provider group information during login.
OIDC and SCIM are separate integrations: OIDC authenticates users, while SCIM provisions user and group lifecycle data.
Rate limiting
Authentication failures trigger progressive lockout by username or IP address. Lockout durations increase from one minute to one hour as failures accumulate, and rate-limit events are recorded for audit review.