Users

Users are the people who authenticate through SqlOS. Each user has an email, a display name, and optionally a password.

Create a user

Dashboard: Auth Server > Users

SDK:

var user = await adminService.CreateUserAsync(new CreateUserRequest
{
    DisplayName = "Jane Doe",
    Email = "jane@acme.com",
    Password = "securePassword123"
});

Admin API:

curl -X POST http://localhost:5062/sqlos/admin/auth/api/users \
  -H "Content-Type: application/json" \
  -d '{"displayName": "Jane Doe", "email": "jane@acme.com", "password": "securePassword123"}'

User types

Type	Created by	Has password
Local	Dashboard or SDK, password optional	Optional
SSO-provisioned	SAML login with auto-provisioning	No
OIDC-linked	Google, Microsoft, Apple, or custom OIDC login	No

Users without a password can only sign in through SSO or OIDC. You can add a password later through the dashboard or SDK.

Email normalization

Emails are normalized on creation (lowercased, trimmed). Use SqlOSAdminService.NormalizeEmail() for consistent lookups:

var normalized = SqlOSAdminService.NormalizeEmail("Jane@Acme.COM");
// → "jane@acme.com"