Skip to main content

Local Authentication

Default authentication using Anaphora's built-in user database. Ideal for small teams, testing environments, or deployments without enterprise identity providers.

Overview

Local authentication provides:

  • Built-in user database — No external dependencies
  • User management UI — Easy administration
  • Quick setup — Works out of the box

User Management

Adding Users

  1. Navigate to Settings > System Settings > Auth > Local
  2. Click Add New User
  3. Enter username, email, and password
  4. Assign roles
  5. Choose user type: Normal user or system user
  6. Save

User Properties

FieldDescriptionRequired
UsernameUnique login identifierYes
PasswordInitial passwordYes
RolesAssigned permission groupsNo
System RoleUser or system user designationYes

System Role

The System Role controls access to system-wide settings:

RoleDescription
userNormal user, cannot access system settings
systemCan access and modify system settings. Has automatically access to all spaces.
note

System settings include authentication configuration, space configuration, backup settings, and other global options. Most users should have the user role.

Managing Local Users

All local users will be managed by the system user alone. Users cannot modify their own accounts. System users can change the password or add roles to existing users. The system user can also delete the local users.

warning

Deleting a user removes their access immediately. Jobs created by the user will remain.

When to Use Local Auth

ScenarioRecommendation
Small team (under 10 users)Local auth is sufficient
Testing/developmentLocal auth for simplicity
No corporate IdP availableLocal auth as primary method
System userLocal is required
Enterprise environmentConsider LDAP, SAML, or OIDC
Compliance requirementsUse enterprise SSO

Next Steps

  • LDAP - Connect to Active Directory
  • SAML - Enable Single Sign-On
  • OIDC - Use OpenID Connect providers