Skip to main content
Version: Next

Authentication Pipeline

auth.pipeline contains request concurrency, retry, cache, password-history, and master-user settings for the authentication pipeline.

auth:
pipeline:
max_concurrent_requests: 100
max_login_attempts: 15
wait_delay: 0
local_cache_ttl: 30s

password_history:
max_entries: 1000

master_user:
enabled: false
user_format: "{user}*{master_user}"

General Settings

KeyTypeDefaultPurpose
max_concurrent_requestsinteger100Maximum number of concurrent authentication requests handled by the pipeline.
max_login_attemptsinteger15Maximum login attempts considered by the pipeline before the request is treated as exhausted.
wait_delayduration/integer0Delay before selected authentication responses.
local_cache_ttlduration30sLifetime for local in-memory auth cache entries.
password_history.max_entriesinteger1000Maximum password-history entries retained per tracked bucket.

Master User

auth.pipeline.master_user.enabled turns on master-user parsing for authentication requests.

auth.pipeline.master_user.user_format defines how the login name carries the requested target user and the authenticating master user. The format uses exactly one target-user placeholder and exactly one master-user placeholder.

Examples:

FormatLogin nameParsed target userParsed master user
{user}*{master_user}alice@example.test*admin@example.testalice@example.testadmin@example.test
{user}#{master_user}alice@example.test#admin@example.testalice@example.testadmin@example.test
{master_user}*{user}admin@example.test*alice@example.testalice@example.testadmin@example.test
login:{user}|via:{master_user}`login:alice@example.testvia:admin@example.test`alice@example.test

The literal text between the placeholders must make the split deterministic. Adjacent target-user and master-user placeholders are invalid because Nauthilus cannot know where one identity ends and the other begins.

The parsed master-user state is available to auth policies as auth.master_user.active for authenticate requests. See Auth Policy Reference for the corresponding policy attributes and examples.