Forwarding authentik events to a SIEM

Forwarding authentik audit events to a SIEM means choosing between a complete container log copy and selected events sent through notification rules and webhooks, then setting local retention to match.

On this page

Why teams forward authentik events to a SIEM

A security or platform team running authentik needs identity events in the same place as the rest of its detection and investigation data. authentik writes every event to container logs at info level, so forwarding the container logs gives you a complete copy of what the platform records. That is the option to pick when the SIEM must hold the full identity trail, for example for investigations that start from an unexpected login and need the surrounding events. Selected events are the other route: an event matcher policy selects the events, a notification transport delivers them (locally, by email or to a webhook), and a notification rule connects the two. The authentik log forwarding documentation describes these components and is the next read before you choose.

The choice usually comes down to volume and ownership. Full container log forwarding is simpler to reason about because nothing is filtered out, but it puts every event, including routine ones, into the SIEM and its licensing or storage budget. Selected events through a notification rule fit a narrower mandate, such as alerting on failed logins or configuration changes, but they only cover what your matchers select, so a detection gap can hide in events nobody thought to match. Authentik also documents forwarding to Splunk Enterprise through the HTTP Event Collector, so confirm whether your SIEM is supported directly or needs a webhook or log shipper in between.

Shortening local retention in authentik should come last. Confirm that the forwarder is running, that events arrive in the SIEM with the fields your rules need, and that you can search them for the full retention period you have committed to before you reduce anything inside authentik. Ask your SIEM vendor or operations team to confirm ingest volume, parsing and retention settings for your event volume, and check the authentik version you run against the authentik release notes before you change log handling during an upgrade.

Choosing between full log forwarding and selected event delivery

This table compares forwarding every authentik container log against sending selected events through notification rules, transports and webhooks, with Splunk's HTTP Event Collector as a named path. Read each row against your SIEM's ingestion and parsing model, and the main takeaway is that full forwarding favors completeness while selected delivery favors a smaller, cleaner feed.

FactorFull container log forwardingSelected events through notification rules
CompletenessEvery authentik event is written to container logs at info level, so the copy is completeOnly events matched by an event matcher policy are sent, so gaps appear if the matcher is incomplete
Filtering effortLittle upfront work, but filtering happens later inside the SIEMRequires an event matcher policy, a transport and a notification rule for each event class
Parsing burdenYour pipeline must parse container log lines from the authentik server and workerWebhook or email payloads are structured by authentik, which can reduce parsing work
Splunk fitContainer logs can reach Splunk through your existing collector, with the full event volumeSplunk Enterprise can receive events through the HTTP Event Collector transport path
Wazuh and OpenSearch fitSuited to collectors that tail container output and index the full streamSuited to webhook receivers that map structured fields into alerts or indices
Volume and retentionAdds full event volume to the SIEM, which affects storage and license sizingKeeps the SIEM feed smaller, but you must still decide what local retention authentik keeps
Ongoing maintenanceFewer rules to change when authentik adds event typesMatchers need review after upgrades so new or changed events are not silently excluded

Setting up the event pipeline step by step

This sequence takes authentik audit events from the running deployment to a SIEM receiver, and each step ends with a check so you know the path works before you rely on it. The order matters because the collection path decides which configuration you build and which receiver settings you need.

  1. Confirm the version and the events you need

    Record the authentik version your deployment runs and check it against the supported lines in the security policy, since the release you run determines the event fields and upgrade path you can depend on. List the events your SOC needs, such as failed logins, configuration changes and impersonation, and decide whether you need every event or a selected subset. Done means you have a written list of versions and event types that the SIEM team has approved.

  2. Choose the collection path

    Pick full container log forwarding if you want a complete copy of every event, or selected forwarding through an event matcher policy, a notification transport and a notification rule if you only need certain events. Consider that full forwarding sends volume the SIEM must ingest and store, while selective forwarding depends on rules you must maintain. Done means the platform owner and the SIEM owner have agreed on one path in writing.

  3. Ship container logs or configure the notification chain

    For full forwarding, configure your log shipper on the host or cluster to read the authentik server and worker container logs. For selective forwarding, create the event matcher policy that selects the events, a notification transport that sends them to a webhook or other destination, and a notification rule that binds the two. Check that the transport and rule show as enabled in the authentik admin interface, then trigger a test event such as a failed login in a non-production account.

  4. Connect the SIEM receiver

    Create the input on the receiving side: a Splunk HTTP Event Collector token for Splunk Enterprise, a log collection input for Wazuh, or an ingest pipeline for OpenSearch. Confirm the endpoint is reachable from the authentik host or cluster, and that TLS and token handling follow your security standards. Done means the receiver shows the input as active and accepts a connection test.

  5. Verify with test events

    Generate known test events, such as a successful login, a failed login and a change to a non-sensitive setting, and search for them in the SIEM. Confirm that each event arrives with the expected fields, including the event action, the username, the source address and the timestamp, and that the timestamps line up with the authentik host clock. Record which fields are missing or renamed so the parsing team can fix them before go-live.

  6. Confirm delivery and set retention

    Run a short period of normal traffic and compare event counts in authentik with counts in the SIEM to confirm that nothing is dropped. Once delivery is confirmed, decide how long authentik keeps events locally and reduce that retention only after the SIEM copy is searchable. Done means the counts match within your agreed tolerance and the retention change is documented with a rollback step.

How authentik events reach the SIEM

Every authentik event is written to container logs at info level, so the server and worker containers are the complete source for a SIEM feed. The server container runs core plus an embedded outpost, and the worker container runs background tasks. Both write to standard output, so a log shipper or the container runtime's logging driver can collect them. PostgreSQL holds all configuration and data except uploaded files, which means the events you see in the admin interface are stored there, but the SIEM does not read from PostgreSQL. Forwarding is a separate path from the database, and retention in PostgreSQL is a separate setting you control. Confirm which containers your collector reads, and confirm that it captures both the server and the worker, since background tasks such as notification delivery run in the worker.

Selected events take a different route. An event matcher policy decides which events qualify, a notification transport defines where they go (locally, by email or to a webhook), and a notification rule connects the two. These sit alongside container logs rather than replacing them, so a rule that sends failed logins to a webhook does not reduce what the container log contains. For Splunk Enterprise, authentik documents forwarding through the HTTP Event Collector, which is a transport choice to plan in advance. Decide whether the SIEM needs the full stream, a filtered stream for alerting, or both, because each choice changes where ingestion and parsing work happens.

On the SIEM side, confirm the ingestion method, the parser or field mapping for authentik's log format, the expected event volume at your tenant size, and how the SIEM handles delivery failures from a webhook. Check with the authentik log forwarding documentation for the current transport options and any transport-specific settings before you build the pipeline. Also confirm where the SIEM must be hosted to meet your data residency and access rules, since that affects whether a managed or self-hosted platform fits. Record these answers in the design, because they determine how much of the pipeline you must test before go-live.

Security and operational considerations for event pipelines

Every event that leaves authentik carries credentials, user identifiers and access decisions into a system you must also secure. The cards below cover the transport and token risks, the personal data inside event content, the gaps that appear when a forwarder fails, and who is allowed to change the rules that decide what gets sent.

Protect webhook and HEC credentials

A Splunk HTTP Event Collector token or a webhook secret lets anyone who holds it write events into your SIEM. Store the token in a secrets manager and inject it into the transport configuration at deploy time, not in a blueprint or a shared document. Confirm that the webhook endpoint uses HTTPS with a certificate your forwarding host trusts, and rotate the token on a schedule your security team defines. Check that the token can only write to the index intended for authentik events.

Encrypt event traffic in transit

Notification transports and forwarders send session identifiers, usernames, source addresses and application names across the network. Plaintext delivery to a collector on another segment exposes that data to anyone with a network position between the two hosts. Require TLS between authentik, any intermediate forwarder and the SIEM listener, and verify certificate chains rather than disabling validation to get a connection working. Test the path with the same configuration used in production.

Limit personal data in event content

Authentik events name the user, the application and often the client address, which makes the SIEM a store of personal data with its own access and retention duties. Decide which fields the SIEM needs for detection and which can be dropped or masked before indexing. Review whether your data protection obligations cover the SIEM copy, and restrict search access to the analysts who need identifiers. Document the field list so the choice can be audited later.

Detect forwarder failures early

A forwarder that stops, a full queue or an expired token produces silence, and silence looks like a quiet period in the SIEM. Monitor the forwarding host's process state and error output, and alert when the SIEM stops receiving authentik events for longer than your normal login pattern allows. Keep the local container logs until you have confirmed that the SIEM copy is complete, since they are the only record of events created during an outage.

Plan for gaps and replay

When a transport fails, events raised during the outage may never reach the SIEM unless something queues or replays them. Ask the implementation team which events are delivered through the container log stream and which through notification transports, since each path has different failure behavior. Write down the recovery procedure, including how to re-read container logs for the missing window and how to load them without duplicating events already indexed.

Control who edits notification rules

Notification rules and event matcher policies decide which events are sent, so changing them can silently stop an alert or redirect data to another destination. Limit edit rights for these objects to a named administrator group, and review changes to them as you would any firewall rule. Confirm that configuration changes to these objects are themselves recorded in the audit trail and forwarded to the SIEM, so that a removed rule leaves a trace.

When shortening local retention is safe

Shorten local event retention in authentik only after the SIEM copy is proven and the SIEM's own retention meets your policy. Local events are the only record until the forwarded copy is verified, so reducing them early can leave a gap that no one notices until an investigation or audit asks for it. Before changing anything, confirm that every event class you rely on arrives in the SIEM with its timestamp, user, source address and event type intact, and that a test event you trigger deliberately (for example, a failed login on a test account) appears there within the window your team considers acceptable.

Local retention also matters for database size. Authentik stores its events in PostgreSQL, so a long local event history grows the database over time, and that growth affects backups and restore times. Check the event retention settings and the cleanup task in the documentation for your exact authentik version, because the setting names and default behavior have changed across releases and should not be copied from an older guide. Confirm the setting and its effect on a staging copy before you change production.

Set the SIEM retention period from your own policy, not from the local setting. Confirm with the SIEM owner how long events are kept, whether the index is replicated or backed up, and who can search them during an incident. Once those answers are written down and a test restore or search of the SIEM data succeeds, reduce local retention in small steps and recheck the forwarding path after each change. Keep a rollback plan in case forwarding stops silently.

Limits to confirm in your environment

Several parts of a SIEM integration depend on details that vary by authentik version, transport and SIEM edition. The cards below list what to verify in your own environment before you build the pipeline, so the design rests on confirmed behavior rather than assumptions.

Event fields each transport sends

Container logs, notification transports and webhooks may not carry the same fields or the same event structure. Capture a sample of each event type from every transport you plan to use, then compare field names, timestamps, user identifiers and source IP values. Confirm whether the webhook payload includes the event context your detection rules need, such as the matched policy or the originating application. Do not assume the schemas match.

Splunk HEC requirements

authentik documents forwarding to Splunk Enterprise through the HTTP Event Collector. Confirm the HEC token, the endpoint URL, TLS trust for your certificate chain, the target index and the sourcetype you want applied, with your Splunk administrator. Check whether your Splunk deployment is Cloud Platform or Enterprise, since the ingest path and the pricing model differ.

Wazuh decoder support for authentik

Wazuh analyzes incoming logs with decoders and rules, so authentik output needs a matching decoder before alerts become useful. Check whether the Wazuh release you run ships a decoder for the authentik log format, or whether your team must write custom decoders and rules. Test with real authentik events from a staging instance, and confirm which rules fire for failed logins and configuration changes.

OpenSearch ingestion method

OpenSearch accepts data through several paths, including its REST API and ingestion tools that your team operates. Decide which path carries authentik events, then confirm index mappings, field types and retention settings with a test index. Check how the Security plugin's audit and role settings apply to the index that receives authentik data, so access to security events matches your access model.

Licensing terms of each SIEM

Each SIEM has its own license, and those terms affect how you can redistribute, modify or host the software. Read the license file of each component you deploy, including Wazuh's GNU General Public License version 2 terms and the OpenSearch Apache License, Version 2.0. For Splunk, confirm the pricing model and support terms with Splunk directly, since the platform pricing page describes ingest and workload options that depend on your data volume.

Current authentik version in use

Confirm the authentik version running in each environment before you write parsers or test event formats, because event fields can change between releases. Check the release notes for the version you run, and confirm which versions still receive security fixes under the project's security policy. Re-verify the forwarding configuration after every upgrade, and record the version in your integration documentation.

Questions teams ask before forwarding authentik events

What does forwarding authentik events to a SIEM cost?

The license cost for authentik itself is not the main line item. authentik's Open Source edition is listed as free on its pricing page, so the spend sits in the SIEM, the storage behind it, and the people who build the pipeline. Splunk prices by data ingest or workload, and Splunk Cloud Platform is priced on activity-based, ingest or workload models, so retained event volume directly drives the bill. Wazuh and OpenSearch are open source, but you still pay for the infrastructure, the indexer storage and the staff time to run them. Ask any partner for a quote that separates one-time build work from recurring items such as storage, SIEM licensing, and ongoing rule tuning.

What drives the effort to forward authentik events?

Effort depends on three choices: whether you forward every container log or only selected events, which SIEM receives them, and how much of the detection logic you build now. Forwarding all container logs is the simplest path because authentik writes every event to container logs at info level. Selecting events requires an event matcher policy, a notification transport and a notification rule, which means more configuration to test. The SIEM side adds parsing, field mapping and dashboards. Ask for a quote that lists each of these as a separate work item so you can see which parts scale with your event volume.

How long does a basic authentik to SIEM pipeline take to set up?

The duration depends mostly on the SIEM, not on authentik. A basic pipeline needs a working authentik instance, a log shipper or transport path, a receiving endpoint, and a first set of parsed fields. Teams that already run a SIEM with a standard ingestion path usually have the shortest route. Splunk Enterprise can receive data through the HTTP Event Collector, which authentik documents, so that path is well defined. Ask any partner for a timeline in the written scope, and confirm the exact steps for your SIEM version with its vendor documentation before committing a date.

What must our team supply before the pipeline work starts?

Plan to supply four things before work begins:

  • Administrative access to the SIEM, including the ability to create inputs, indexes or data streams and roles for the new source
  • Network paths from the authentik server or worker containers to the SIEM endpoint, with firewall rules and TLS certificates agreed in advance
  • Access to the authentik admin interface to create transports, policies and notification rules
  • A named owner for detection rules and alert routing, so that tuning decisions are not left to whoever built the pipeline

Confirm the exact access level each SIEM requires with its own documentation, and record the answers in the written scope.

Who should own the detection rules after the pipeline is live?

Your security operations team should own detection rules, alert thresholds and routing after handover. The partner or internal engineer who builds the pipeline should document the event types, field names and rule logic, but the rules themselves need an owner who can respond to alerts and change them. Ownership gaps are a common reason SIEM pipelines produce noise or go silent after launch. Ask for a handover that names the rule owner, the review cadence, and the process for adding new authentik event types after upgrades.

Can our team set up authentik event forwarding without a partner?

Yes, a team with authentik and SIEM administration skills can forward container logs or configure notification rules and transports directly, using the authentik log forwarding documentation. The steps are documented and bounded. Teams usually need outside help when the SIEM is new to them, when they must map fields for compliance reporting, or when they need to shorten local retention without losing audit evidence. Test the pipeline end to end with a known event, such as a test login, before relying on it.

When does a partner help with authentik SIEM forwarding?

A partner helps most when the work crosses several teams or carries compliance weight. Common cases include a regulated environment that needs a documented audit trail, a SIEM migration that changes the receiving platform, a need to reduce local retention while keeping evidence for review, or a team without spare engineering capacity. DeployOpen plans, implements, integrates and documents self-hosted open-source platforms in your own infrastructure, and prepares evidence for compliance assessments, but it does not issue audit reports or certifications. Scope, deliverables and timelines are agreed in writing before work starts.

How DeployOpen scopes and delivers SIEM event forwarding

DeployOpen plans, implements, hardens, documents and supports self-hosted open-source platforms inside your own infrastructure, so authentik event forwarding is designed around your SIEM, your retention rules and your network. We agree the scope in writing before work starts, then build, test and hand over the forwarding path with the runbooks your team needs.

How we scope

  • Confirm which authentik events must reach the SIEM, and whether all container logs or selected events through notification rules are needed.
  • Record the SIEM target, whether Splunk, Wazuh, OpenSearch or another platform, and where it runs in your infrastructure.
  • Agree in writing the local retention period to keep on authentik and the owner of each downstream log store.

How we build

  • Set up container log collection from the authentik server and worker, with a parser and index mapping matched to your SIEM.
  • Configure event matcher policies, notification transports and notification rules for any selected events, such as webhook delivery.
  • Test each event type end to end, confirming that a failed login or configuration change arrives in the SIEM with the expected fields.

How we hand over

  • Deliver a written record of the forwarding design, configuration files, event coverage and the retention settings applied.
  • Document how to add or remove forwarded events, rotate SIEM credentials and confirm delivery after an authentik upgrade.
  • Walk your operations and security staff through the runbook and the checks they should run when forwarding stops.

How we support

  • Support after handover is available as a retainer covering authentik upgrades, SIEM changes and forwarding fixes.
  • Ongoing retainers can also include continuous security testing of the forwarding path and related authentik services.
  • Ask for a quote based on the written scope, which states who maintains the SIEM side and who maintains authentik.

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.