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:
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.
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 Role | Assigned Login Shell | OS, 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-opshell | Operational 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/nologin | Read-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 custom | Standard 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 ID | Service Account (ou=services) | Auto-Provisioned POSIX Groups & GIDs |
|---|---|---|
| eluvix | cn=svc-eluvix | eluvix-admin (10200), eluvix-operator (10201), eluvix-readonly (10202) |
| freeradius | cn=svc-freeradius | radius-users (10210) |
| vigilant-octo-waffle | cn=svc-vow | vow-admin (10220), vow-operator (10221), vow-readonly (10222) |
| core-vigilante | cn=svc-vigilante | vigilante-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.
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:
SsoConfigSchema supports standard oidc, Microsoft entra, okta, and google Workspace, mapping IdP groups claims directly into admin, operator, or readonly JWT sessions.
ZeroTrustConfigSchema (engine/iap.go) publishes internal HTTP services on publicHostname behind mandatory SSO/LDAP session verification and fail-closed allowedRoles checks.
/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:
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: 90sshPublicKey credentials, inspect live syncrepl CSN sync status, and configure OIDC/Entra/Okta role mappings at /system/users and /security/zero-trust.