Repository navigation
NS8 OpenID Connect
- Choose a published NethServer IdP, Keycloak, or LemonLDAP::NG provider and user domain in Settings. OIDC can run alongside LDAP, including with a different domain, or serve as the only external sign-in method.
- Run
runagent -m openbao1 openbao-auth applyon the node to register the client and configure OpenBao. OIDC is disabled by default. The default OIDC role grants no secret or administrator access.
Shared identities
When both methods use the same NS8 user domain, an administrator can link verified LDAP and OIDC aliases to one OpenBao entity. Each method continues to issue its own tokens and method-specific policies.
Local recovery
Run runagent -m openbao1 openbao-auth recovery set while OpenBao is unsealed and you have an administrator token. This creates an optional local breakglass account that works when both external providers are unavailable. Rotating the password revokes earlier recovery tokens. Keep the unseal or recovery material required by your initialization mode.
Compatibility and verification
The upstream OpenBao image remains at 2.7.2. Debian 13 and Rocky 9 passed QEMU testing. A local HTTPS fixture also verified the OIDC callback and sign-in.
Configuration and recovery guide · Promotion PR · QEMU results · Full changelog