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.