Unified Identity Plane • OpenLDAP + SSSD + OIDC SSO

Unified Appliance Identity: OpenLDAP, Role Shells & Enterprise SSO

Axonwall eliminates fragmented credential silos across the Web Console, SSH/serial CLI, ZFS SMB/NFS shares, FreeRADIUS 802.1X, VPN tunnels, and Kubernetes SecOps apps. Every appliance bootstraps a zero-touch embedded OpenLDAP (slapd) + SSSD directory paired with external OIDC/SAML federation, an Identity-Aware Reverse Proxy, and a hardened restricted operator shell (axonwall-opshell).

1. Zero-Touch Embedded OpenLDAP (cn=config) & SSSD

On first boot, DirectoryManager (apps/axonwalld/engine/directory.go, slapd_bootstrap.go, and sssd.go) automatically initializes an LMDB-backed slapd instance under /var/lib/axonwall/ldap/ with back_mdb, syncprov, ppolicy, unique, and accesslog overlays:

Automatic Base DN & ppolicy Enforcement

DeriveBaseDN() converts system.domain into an RFC 2247 Base DN (e.g. fw.corp.local → dc=fw,dc=corp,dc=local). IdentityConfigSchema programs OpenLDAP's ppolicy overlay with minimum password length (default 12), brute-force lockout (5 failures → 900s lockout), password history (5), and optional max age.

SSSD NSS/PAM, SSH Keys & Root SSH Lockdown

Configures /etc/sssd/sssd.conf (files sss in nsswitch.conf + pam_mkhomedir.so, with automatic 15s NSS mirroring on musl/Alpine) and installs /usr/local/bin/axonwall-ssh-authorizedkeys so sshd resolves sshPublicKey attributes directly from LDAP. Once an unlocked admin exists, disableRootSshWhenAdminExists: true automatically disables direct PermitRootLogin while preserving emergency scrypt break-glass recovery.

2. Four-Tier Appliance RBAC & Hardened axonwall-opshell

Assigning an applianceRole to any directory user synchronizes Web Console JWT privileges, POSIX group memberships, /etc/sudoers.d/axonwall rules, and login shells across the OS:

Appliance RoleAssigned Login ShellOS, SSH & Web Console Capabilities
admin/usr/bin/zsh (/bin/zsh)Full superuser across Web Console, API (axonwall-api), Oh My Zsh + Starship interactive shell, Neovim Super Configurator (axonwall-config), and %axonwall-admin NOPASSWD: ALL sudo.
operator/usr/local/bin/axonwall-opshellOperational Console access + restricted SSH menu launching axonwall-tui --readonly, NastyMap diagnostics, axonwallctl status|diff|validate, and bounded journal logs, with a strict SSH -c command allowlist preventing shell escape.
readonly/usr/sbin/nologinRead-only compliance & SOC auditor visibility in the Web Console and REST API with zero interactive SSH or TTY shell login permitted on the host OS.
os_only/usr/bin/zsh or customStandard POSIX / ZFS SMB share / NFSv4 / FreeRADIUS 802.1X / WireGuard & OpenVPN user account with zero Web Console administrative privileges.

3. Automatic Plugin LDAP Service-Account & Group Provisioning

Plugins declaring a PluginLdapIntegrationSpec never require manual LDAP bind setup. DirectoryManager automatically creates isolated bind accounts under ou=services,<baseDN> with unique 192-bit random secrets in /var/lib/axonwall/secrets/ldap/plugins/, writes client binding manifests to /etc/axonwall/ldap-plugins/, and provisions POSIX RBAC groups (GIDs 10200–10232) that automatically inherit axonwall-admin, axonwall-operator, and axonwall-readonly memberships:

Plugin IDService Account (ou=services)Auto-Provisioned POSIX Groups & GIDs
eluvixcn=svc-eluvixeluvix-admin (10200), eluvix-operator (10201), eluvix-readonly (10202)
freeradiuscn=svc-freeradiusradius-users (10210)
vigilant-octo-wafflecn=svc-vowvow-admin (10220), vow-operator (10221), vow-readonly (10222)
core-vigilantecn=svc-vigilantevigilante-admin (10230), vigilante-operator (10231), vigilante-readonly (10232)

4. Active-Active Multi-Provider syncrepl HA & Upgrade Safety

When High Availability is enabled across two Axonwall appliances, OpenLDAP automatically upgrades into a symmetric Active-Active Multi-Provider (olcMirrorMode: TRUE) pair (olcServerID 1 & olcServerID 2) using real-time refreshAndPersist delta-syncrepl over mutual-TLS ldaps://:636 pinned to the internal HA PKI CA.

Live ContextCSN Drift Monitoring & Pre-Upgrade LDIF Snapshots
DirectoryStatus continuously compares local contextCSN against peer peerContextCSN and NTP clock skew (clockSkewMs), while configuring SSSD with dual-URI failover (ldap://127.0.0.1:389, ldaps://<peer>:636). Before every A/B image update (axonwall-update), slapcat exports signed cn=config and data LDIF backups into /var/lib/axonwall/ldap/backups/.

5. Enterprise OIDC SSO, Zero-Trust IAP & Self-Service VPN Portal

External cloud identity providers, clientless application access, and end-user VPN onboarding are configured declaratively in /etc/axonwall/security.yaml:

OIDC / Entra / Okta / Google SSO

SsoConfigSchema supports standard oidc, Microsoft entra, okta, and google Workspace, mapping IdP groups claims directly into admin, operator, or readonly JWT sessions.

Zero-Trust Identity-Aware Proxy

ZeroTrustConfigSchema (engine/iap.go) publishes internal HTTP services on publicHostname behind mandatory SSO/LDAP session verification and fail-closed allowedRoles checks.

Self-Service VPN Portal (/vpn)

Authenticated directory and SSO users can visit the self-service portal at /vpn to download personalized WireGuard .conf files, scan mobile WireGuard QR codes, or export OpenVPN client bundles without opening IT tickets.

/etc/axonwall/security.yaml (SSO & Zero-Trust IAP) + Identity Policy
yaml
# /etc/axonwall/security.yaml
sso:
  enabled: true
  provider: "entra"
  displayName: "Corp Microsoft Entra ID"
  issuerUrl: "https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000/v2.0"
  clientId: "axonwall-perimeter-console"
  clientSecret: "ENC[scrypt_vault_placeholder]"
  redirectUri: "https://fw.corp.example.com:2966/api/auth/sso/callback"
  scopes: ["openid", "profile", "email", "groups"]
  groupClaim: "groups"
  roleMappings:
    - idpGroup: "NetSec-Platform-Admins"
      role: "admin"
    - idpGroup: "SOC-Tier2-Operators"
      role: "operator"
    - idpGroup: "GRC-Compliance-Auditors"
      role: "readonly"

zeroTrust:
  enabled: true
  apps:
    - name: "Internal Grafana Observability"
      publicHostname: "grafana.corp.example.com"
      internalUpstream: "http://10.10.20.15:3000"
      allowedRoles: ["admin", "operator"]
      allowAnyAuthenticated: false
      enabled: true

# Optional OpenLDAP ppolicy & Root SSH Lockdown (in axonwall.yaml / conf.d/identity.yaml)
identity:
  disableRootSshWhenAdminExists: true
  passwordPolicy:
    minLength: 14
    maxFailures: 5
    lockoutDurationSeconds: 900
    historyCount: 8
    maxAgeDays: 90
Manage Directory Users, Groups, LDAPS Sync & SSO in Web Console
Create and audit OpenLDAP users, upload sshPublicKey credentials, inspect live syncrepl CSN sync status, and configure OIDC/Entra/Okta role mappings at /system/users and /security/zero-trust.