Access / User Management


The user manager of OPNsense allows for controlling access to the different part (pages) of the configurator as well as controlling access to particular services on a per user bases.


OPNsense offers integration with external servers for services that require user authentication. These services include:

  • IPsec

  • OpenVPN

  • Captive Portal

  • Proxy

Integrated into OPNsense are the Local User Database and Voucher Server. The Voucher Server is intended to be used with the Captive portal.

External service currently supported are:

  • LDAP (OpenLDAP, MS Active Directory, Novell eDirectory)

  • Radius


Besides authenticating, user authorization to access parts of the configuration can also be setup with an external server, but in order to grant the appropriate privileges to the users they need to be imported in OPNsense’s local user manager. This way one can validate a user against its externally stored password and have a fine grained control over the configuration pages that user may access.

Users, Groups & Privileges

When using the local user manager, either stand alone or on combination with an external authentication server one can define groups to combine a set of privileges for a specific user group. A user should be an individual, a group needs to be specific in such a way that anyone of that group can be granted the same access rights, called privileges.

Authentication services

Authentication services can be configured using the settings in System ‣ Access ‣ Servers. This includes both local accounts and remote authentication.

By default, OPNsense GUI login will use local accounts. This can be changed, however, by going to System ‣ Settings ‣ Administration, scrolling down to the “Authentication” group, and changing the ‘Server’ option.

Local account configuration

Settings for handling login via local accounts can be set by going to System ‣ Access ‣ Servers, then clicking the ‘Edit’ icon (a pencil) for ‘Local Database’. Here, you can improve security of local user accounts by setting password length and complexity constraints.

An overview of available settings:


Enable password policy constraints.


[Policy] Password duration, optionally define how often the user should change his or her password.


[Policy] Minimum password length to require.


[Policy] Enforce password complexity checks.