authentik and Elastic Cloud SAML integration

Connect self-hosted authentik to Elastic Cloud organization SSO over SAML, with the Enterprise subscription, claimed domain, Organization owner role mapping and groups attribute in place before sign-in is enforced.

On this page

How authentik signs users in to Elastic Cloud over SAML

The supported method for routing Elastic Cloud logins through authentik is SAML SSO, as described in the authentik integration guide for Elastic Cloud. SAML SSO requires an Enterprise subscription on Elastic Cloud and at least one claimed domain, so confirm both before any configuration starts. In this arrangement authentik is the identity provider, meaning it authenticates the user and issues a signed SAML assertion, while Elastic Cloud is the service provider, meaning it trusts that assertion to create or match an Elastic Cloud user and assign roles. Responsibility splits along that line: authentik holds the user's password, MFA factors and group membership, and Elastic Cloud decides what the signed-in user can do inside the organization.

The integration depends on two pieces of identity data arriving intact. The first role mapping you create in Elastic Cloud must include the Organization owner role, and the guide's sequence should be followed exactly so that at least one administrator can still manage the organization if a later mapping is wrong. The groups attribute that authentik sends in the assertion is what your other role mappings will match against, so decide which authentik groups correspond to which Elastic Cloud roles before you build the mappings. Ask your Elastic representative and review the Elastic Cloud SAML documentation to confirm the current attribute names and claimed domain steps for your deployment, since the guide is the authority for those details.

DeployOpen configures the authentik side and documents the Elastic Cloud side for your organization, but it does not verify Elastic's own certifications, attestations or compliance reports, and it cannot promise how Elastic Cloud will treat your account after a subscription change. Your identity and security teams should confirm with Elastic how SAML login interacts with local Elastic accounts, API keys and break-glass access before go-live, because those decisions determine whether a failed identity provider can lock out the whole organization.

What you need before configuring Elastic Cloud SSO

Four things have to be in place before any SAML settings are entered: the Elastic subscription, a domain you can prove you control, a supported authentik release, and people and groups ready for the first login. Confirm each one with the owning team, because a gap in any of them stops the setup at the claim or role mapping step.

Enterprise subscription for SAML

The authentik Elastic Cloud guide requires an Enterprise subscription before SAML SSO can be turned on for the Elastic Cloud organization. Check the subscription level on the account in Elastic's console, not only the plan named in a sales conversation. Plan names and prices change, so confirm the current Enterprise terms and the price on Elastic's pricing pages before you buy.

A claimed domain you control

SAML SSO needs at least one claimed domain, which is an email domain your organization proves it owns inside Elastic Cloud. Pick the domain that your users' email addresses use, and confirm that you can edit its DNS records or otherwise complete the verification steps. Users whose email domain is not claimed will not be routed through authentik.

Supported authentik release

Run authentik on a line that still receives security fixes. The security policy lists 2026.5.x and 2026.8.x as the supported versions. Check your running version in the admin interface, and plan an upgrade if you are on an older line, since the project announces security releases at least 24 hours in advance.

Named Organization owner

The first role mapping must grant the Organization owner role, so the person who will hold that role needs a named account in authentik before you start. Choose someone who can manage the Elastic organization after go-live, and make sure a second administrator exists so the organization is not locked to one person. Record who holds the role and when it was assigned.

Directory groups to pass to Elastic

Elastic maps roles from a groups attribute sent in the SAML assertion, so decide which authentik groups will be sent and what each one should grant in Elastic. Confirm the exact attribute name and group format in the authentik guide before creating mappings. Keep the list short, name groups for their Elastic role, and confirm who approves changes to group membership.

Configuring the SAML provider, claimed domain and first role mapping

This sequence connects an authentik SAML provider to an Elastic Cloud organization, proves a test login works, and only then turns on enforced SSO. Each step ends with a check so the team can confirm the integration before users depend on it.

  1. Confirm the Enterprise subscription and access

    Before any configuration, the Elastic Cloud account owner confirms that the organization is on an Enterprise subscription, since SAML SSO requires it according to the authentik Elastic Cloud guide. The authentik administrator confirms they hold an administrator role with rights to create providers and applications. Confirm the subscription tier in the Elastic Cloud console and check which subscription terms apply to your contract with Elastic, because the subscriptions page notes that tier rules differ across products. Done means the tier is recorded and both administrators have the access they need.

  2. Claim the email domain in Elastic Cloud

    In the Elastic Cloud organization settings, the owner adds the email domain your users sign in with and starts the domain claim. The guide requires at least one claimed domain before SAML SSO can be used. Elastic will show a verification state for the domain, and the claim must reach a verified status before the identity provider can be tied to it. Done means the domain appears in the organization's claimed domains with a status you have recorded, and you know which DNS or verification step is still pending, if any.

  3. Create the SAML provider and application in authentik

    In authentik, the administrator creates a SAML provider and an application for Elastic Cloud, using the Elastic Cloud details from the authentik integration guide, including the metadata and Assertion Consumer Service (ACS) values Elastic supplies for the organization. Set the signing certificate and the name ID mapping so that the email address matches the claimed domain. Include a groups attribute in the assertion, because Elastic uses it when mapping users to roles. Done means the provider saves without errors and the metadata you exported matches what the guide expects.

  4. Bind the application to users or groups

    The administrator binds the Elastic Cloud application to the authentik users or groups who should sign in, using the authentik policy or binding options. Limit the first binding to a small pilot group, such as the people who will test the login and hold administrator roles in Elastic. Keep a break-glass local login available on the Elastic side until SSO is proven. Done means a test user from the pilot group is allowed to start the flow and a user outside the group is refused.

  5. Create the first role mapping with the Organization owner role

    In Elastic Cloud, the owner creates the first role mapping, and the guide requires that this mapping include the Organization owner role. Map the groups attribute value from authentik to that role, so the pilot administrator can manage the organization after signing in. Add further mappings for other roles only after this one works. Done means the mapping is saved, it lists the Organization owner role, and it references the group value that the authentik assertion sends.

  6. Test a login from a second browser session

    The pilot administrator starts an SSO login from the authentik application while keeping the existing Elastic Cloud session open in a separate browser or private window to avoid losing administrative access. Confirm that the user lands in the Elastic Cloud organization with the expected Organization owner rights and that the claimed domain user account is created or matched correctly. Check the authentik event log and the Elastic audit information if they are available to you. Done means the test login succeeds, the role is correct, and no errors appear in either system.

  7. Enforce SSO for the organization

    Once the test login is confirmed and at least one other owner has verified access, the Elastic Cloud owner turns on SSO enforcement for the organization. Confirm the change with a second owner before saving, because enforcement can block local-only accounts. Then repeat a login from a fresh session as a non-owner user to check the rest of the access model. Done means enforcement is active, the pilot login still works, and the rollout plan for the remaining users is written down with an owner named for each step.

How the SAML assertion carries identity and roles to Elastic Cloud

The SAML assertion is the only identity record Elastic Cloud receives at sign-in, so every role a user gets in the Elastic Cloud organization depends on what authentik puts in that assertion. When a user opens Elastic Cloud and chooses SSO, Elastic Cloud sends a SAML authentication request to authentik, the user is redirected to the authentik login page, and authentik runs the flow configured for that application. Authentication and any multi-factor prompt happen inside authentik, not in Elastic Cloud. Once the user has passed the flow, authentik sends a signed SAML response back to Elastic Cloud through the browser, and Elastic Cloud reads the user's identity and attributes from it. Before go-live, confirm the exact attribute names, the NameID format and the assertion signing settings against the current authentik Elastic Cloud guide, because these must match what Elastic Cloud expects on its side.

The groups attribute is what connects the identity provider to Elastic's role model. Elastic Cloud does not decide access from authentik group membership by itself. Instead, it evaluates role mappings against the attribute values in the assertion, so each authentik group a user belongs to must appear as a value in the groups attribute that the mapping rules can match. The guide requires that the first role mapping include the Organization owner role, which gives the organization a working administrator path before broader mappings are added. Plan the group names, the mapping rules and a named break-glass administrator together, and test with a non-owner account before you widen access. Remember that a mistake here can lock out administrators, so keep an account that can sign in without the SSO path until the mappings are verified.

Attributes and roles mapped from authentik to Elastic Cloud

This table lists each identity attribute authentik sends in the SAML assertion, the authentik source that supplies it and the Elastic Cloud field it populates. Attribute names marked for confirmation must be checked against the authentik Elastic Cloud guide before you finalize the property mappings. The main takeaway is that the first role mapping must include the Organization owner role, or the initial sign-in will not give anyone administrative control of the organization.

Itemauthentik sourceElastic Cloud field or rule
Email address (NameID or email claim)User email attribute in the authentik user recordMatched to the Elastic Cloud user identity; confirm the exact attribute name in the integration guide
Display name (given and family name)User name fields mapped through a SAML property mappingPopulates the user's profile name; confirm the attribute names the guide expects
Groups attributeauthentik group membership, exposed through a SAML property mappingUsed by role mappings to assign Elastic Cloud roles; confirm the attribute name, such as a groups claim, in the guide
First role mappingAn authentik group that holds your Elastic Cloud administratorsMust include the Organization owner role, or no user can manage the organization after first sign-in
Subsequent role mappingsAdditional authentik groups for read-only, billing or deployment rolesMap each group to the Elastic Cloud role it needs; keep the owner group small and reviewed
Claimed domain checkEmail domain of the authenticated userUsers must belong to a claimed domain; confirm that every user domain is claimed before enforcing SSO
Group changes after first loginGroup membership in authentik at each sign-inRole assignments update when the assertion changes; test a removed group to confirm the role is revoked

Subscription and plan choices that affect the integration

SAML single sign-on for an Elastic Cloud organization depends on the Elastic subscription level, not only on the identity provider. The authentik Elastic Cloud guide states that SAML SSO requires an Enterprise subscription and at least one claimed domain. Confirm the subscription on the Elastic side before you configure authentik, because the role mapping and domain claim cannot be finished without it.

  • SAML requires Enterprise: The integration guide calls for an Enterprise subscription for SAML SSO.
  • Claimed domain: At least one domain must be claimed in the Elastic Cloud organization before SSO can be enforced.
  • Platinum is closed to new customers: Elastic states that the Platinum tier is no longer available for new customers, so it is not a fallback option for a new build.
  • Alerting depends on tier: Alerting rules based on anomaly detection or SLOs need Platinum or Enterprise.
  • Cross-cluster operations: These require the same subscription tier on every cluster involved, so a mixed-tier estate needs review.

Ask Elastic to confirm in writing which tier applies to your organization and which features that tier includes before you schedule the integration.

Security settings for SSO into Elasticsearch data

A SAML link to Elastic Cloud puts the authentication decision in authentik, so the controls that matter sit on both sides of the connection. The cards below cover the SAML application, the authentik policies that gate sign-in, the Elastic Cloud role mappings and the recovery path if SSO fails.

Signing and encryption on the SAML application

Decide whether authentik signs the SAML response, the assertion or both, and whether assertions are encrypted. Match the signing certificate and algorithm to what the Elastic Cloud side accepts, and confirm that the metadata you load into Elastic Cloud comes from the authentik instance you intend to run. Record the certificate expiry date and assign a owner for renewal, because a lapsed certificate blocks every Elastic Cloud sign-in at once.

Enforcing MFA in authentik

Elastic Cloud does not decide how a user proves identity when SAML is in use, so the second factor has to be enforced in authentik. Attach an authentication flow with an MFA stage to the application's bindings, and require it for every group that can reach Elastic Cloud. Test a user without an enrolled factor to confirm that enrollment or denial happens as designed.

Restricting access to named groups

Bind the application only to the groups that need Elasticsearch data, and deny everyone else with a policy binding rather than relying on users not knowing the URL. Keep the group list short and reviewed, since each group becomes a path into the Elastic Cloud organization. Note which groups carry the Organization owner role mapping, because those members can change the organization's configuration.

Break-glass local administrator in Elastic Cloud

Keep at least one local Elastic Cloud administrator account that does not depend on the authentik connection. Store its credentials in a sealed, audited location and test that the account can sign in, without using it for daily work. Write a procedure that states who may use it, how the use is recorded and how the account is disabled again after an incident.

Reviewing role mappings after each change

Role mappings decide what each authentik group becomes inside Elastic Cloud, so review them after every change to group names, group membership rules or the SAML attribute that carries groups. Confirm that the first mapping still includes the Organization owner role and that no broad group receives more access than its job requires. Keep the reviewed mapping list with the change record.

Enhanced audit logging on Enterprise

Enhanced audit logging is listed as an Enterprise feature on the authentik pricing page. Where the organization must show who signed in, when and under which policy, confirm that the subscription includes it and that logs are forwarded to storage the security team controls. Ask the vendor which events are captured before relying on them for an investigation.

How to test SSO before enforcing it

How do I test authentik SSO with Elastic Cloud before enforcing it?

Test with a small pilot group of named users before you require SSO for the whole organization. Keep at least one local administrator account that can still sign in with a password, so you can recover if the SAML connection fails. Run each check below with a real test account, record the result, and only enforce SSO once every check passes. Confirm the exact enforcement behavior and the fallback path for your Elastic Cloud organization in the authentik integration guide and Elastic's documentation before you change anything in production.

How do I verify that my claimed domain is active in Elastic Cloud?

Confirm that the domain you claimed in Elastic Cloud shows as verified and that the test users' email addresses use that exact domain. A user whose email domain does not match a claimed domain will not be routed through the SAML connection, so they will sign in another way or not at all. Check this before the pilot begins, because a domain that is still pending blocks the rest of the tests. Also confirm that your Enterprise subscription is active, since the authentik guide requires it for SAML SSO.

How do I check that the owner and standard user roles are assigned correctly?

Sign in with one test account that should receive the Organization owner role and one that should receive a standard role, then check each account's role in the Elastic Cloud organization settings. Both checks matter. The first role mapping in authentik must include the Organization owner role, so the owner test confirms that mapping works, and the standard user test confirms that other mappings do not grant more access than intended. Record which authentik group produced each result so you can trace any mismatch.

How do I confirm that authentik groups map to the expected Elastic Cloud roles?

Create a short matrix that lists each test user, their authentik groups, and the Elastic Cloud role they receive after signing in. Each row should match the mapping you designed, and any extra or missing role is a defect to fix before enforcement. Pay attention to users in more than one group, because their result depends on how the roles combine. Keep the groups attribute in the SAML assertion consistent with the group names used in the mappings, since a name mismatch is a common cause of users landing with no role.

How do I test deprovisioning in an authentik and Elastic Cloud setup?

Remove a test user from the relevant authentik group or deactivate the account, then try to sign in to Elastic Cloud with that user. Access should stop, and the user should no longer appear as an active member in the organization after the change is applied. Repeat the check for a user who had the owner role, because removing an owner needs its own review. Document how long the change took to take effect and whether existing sessions remained active, so your offboarding process reflects what actually happens.

Which logs should I review on the authentik side during an SSO test?

Review the authentik event log for each test sign-in, looking for the authorization, the application access and any policy denials tied to the Elastic Cloud provider. Then review the Elastic Cloud side for the sign-in and role assignment events available to your organization. Compare the two timelines for the same test user, because mismatched timestamps or missing events usually point to a claim or routing problem. Forward logs to your central system if your audit process requires them, and confirm your enhanced audit logging needs against your authentik edition.

What should I check before expanding SSO from the pilot to all users?

Expand only when every pilot check passes on repeated sign-ins, not just the first one. The main items are a verified claimed domain, correct owner and standard role assignment, group-to-role results that match the design, successful deprovisioning, and clean logs on both sides. Also confirm that the local administrator fallback still works and that the people who handle support know the recovery steps. Keep the test records as evidence for your change review, and schedule a short review after the first full week of enforcement.

Can DeployOpen run the SSO test for our Elastic Cloud organization?

DeployOpen can plan and carry out the pilot as part of a fixed-scope engagement, covering the authentik configuration, the Elastic Cloud settings, the test matrix and the evidence record. The scope, deliverables and timeline are agreed in writing before work starts, and a quote follows from that scope. Your team still owns the Elastic Cloud subscription, the claimed domain and the approval to enforce SSO. Your own administrators can also run these tests with the matrix described here if they have the access and time.

Common Elastic Cloud SSO failures and how to fix them

This table lists the failures teams most often hit when enabling SAML SSO for Elastic Cloud with authentik, with the cause and fix for each. Work through the rows in order, because the subscription, domain and first role mapping checks gate everything after them.

FailureLikely causeFix
No SSO option in Elastic CloudThe organization does not have an Enterprise subscription, which the authentik guide requires for SAML SSOConfirm the subscription tier in Elastic Cloud before editing authentik. Plan tier requirements are listed on the Elastic subscriptions page
SSO login rejected for the domainNo claimed domain exists, or the domain is not verified in Elastic CloudClaim the email domain in Elastic Cloud, complete verification, then retry the login from authentik
Administrator locked out after the first loginThe first role mapping does not include the Organization owner role, so no user holds the owner roleUse a break-glass local owner account, then correct the first role mapping to include Organization owner before enforcing SSO
Users sign in but get no rolesThe groups attribute is missing from the SAML assertion, or its name differs from the one Elastic Cloud expectsCompare the attribute name in the authentik SAML property mapping with the guide, correct the spelling and case, then test with a user who belongs to a mapped group
Assertion accepted but role mapping does not matchGroup names in authentik differ from the values used in the Elastic Cloud role mappingCopy group names exactly from authentik into the role mapping rules and check for trailing spaces or case differences
SAML error about signature or certificateThe certificate in Elastic Cloud does not match the signing certificate authentik uses, often after a rotationRe-download the signing certificate from the authentik provider and upload it again in Elastic Cloud, then retest
Login returns to authentik with an error about the destinationThe ACS URL or entity ID in the authentik provider does not match the values Elastic Cloud shows for the deploymentCopy the ACS URL and entity ID from the Elastic Cloud SSO setup screen into the authentik provider without edits, then save and retest
Some users locked out after enforcing SSOAccounts that have no matching identity, or no mapped group, cannot receive a role after enforcementConfirm each user exists in authentik and belongs to a mapped group before enforcement, and keep one local owner account for recovery

Questions buyers ask before configuring Elastic Cloud SSO with authentik

What does Elastic Cloud SSO with authentik cost, and what drives it?

The cost comes from three separate places: the Elastic subscription, the authentik edition and the labor to configure both sides. SAML SSO on Elastic Cloud requires an Enterprise subscription, so the Elastic side is the largest recurring line item for most organizations. Elastic's Cloud Hosted pricing page lists starting prices of $99 per month for Standard, $114 for Gold, $131 for Platinum and $184 for Enterprise, based on a production configuration with 120 GB of storage across 2 zones, with instance usage priced on top. Those figures are starting points, so confirm the current numbers and your own deployment size with Elastic. On the authentik side, the SAML provider used for Elastic Cloud sits in the Enterprise edition, which the authentik pricing page lists at $5 per user per month billed annually plus $0.02 per external user per month. Labor is one-time for the initial build and recurring when roles or groups change. Ask any partner for a quote that separates these components and states which party pays for each.

How long does an Elastic Cloud SAML integration take?

Duration depends on how many roles and groups must map, how many domains need claiming, and whether your identity groups already exist in authentik. The technical configuration itself is short, but the timeline usually stretches around decisions: which authentik groups map to which Elastic roles, who approves the first owner mapping, and how domain verification is coordinated with your DNS team. Elastic's own subscription rules can also affect the schedule, because cross-cluster operations need the same subscription tier on every cluster involved. A fixed-scope engagement sets the timeline in writing before work starts, so ask for the dependencies to be listed as milestones rather than accepting a single estimate.

What must our organization provide before the integration starts?

You need four things ready before configuration begins:

  • An Elastic Cloud deployment on an Enterprise subscription, with an Organization owner account that can change SSO settings.
  • A running authentik instance that you control, with an Enterprise license if you use the SAML provider for Elastic Cloud.
  • At least one domain you can claim and verify in Elastic Cloud, with access to the DNS records needed for verification.
  • A written group model in authentik that lists which groups map to which Elastic roles, including the Organization owner role required in the first role mapping.

Also confirm who in your organization approves changes to the groups attribute, since that attribute drives who receives which access in Elastic.

Can our own team configure Elastic Cloud SSO with authentik without a partner?

Yes, a team with administrative access to both Elastic Cloud and authentik can complete the configuration, provided it has someone who understands SAML assertions and role mapping. The risky part is not the clicks but the ordering: the first role mapping must include the Organization owner role, and a mistake there can lock out administrators from the Elastic organization. Teams that build internally should first test the flow with a non-production deployment and write down the group names and attribute values before touching production. A partner adds most value when the scope covers many roles, existing directory clean-up, or evidence that an auditor will later review.

Does SSO change Elasticsearch data or how backups work?

Configuring SSO changes identity settings and role mappings, not the indices or documents stored in Elasticsearch. Backups remain a separate concern, and Elastic's documentation states that taking a snapshot is the only reliable and supported way to back up a cluster. Snapshots cannot be restored to an earlier Elasticsearch version, and restored indices must be compatible with the target cluster's version. Before changing identity settings, confirm that a recent snapshot exists and that your restore process has been tested. Do not treat the SSO change as a backup event, and take a snapshot before any upgrade that accompanies the integration.

Which authentik group claims and roles should we plan for Elastic Cloud?

Plan the groups attribute before you configure the connection, because it determines what Elastic Cloud does with each signed-in user. Define a small set of authentik groups, map each one to a single Elastic role, and keep the owner mapping limited to the people who must administer the organization. Name the groups clearly, avoid overlapping membership, and document who can add users to each group. Ask whether your Elastic role model needs custom roles, since adding roles later means revisiting the mappings and the groups attribute on both sides.

What should we confirm about Elastic and authentik licensing before buying?

Confirm three things separately. First, the Elastic subscription tier that includes SAML SSO, since SAML requires an Enterprise subscription. Second, the authentik edition and license terms, because most code is under the MIT license while the enterprise directory is under its own license. Third, whether your Elastic plan includes features that depend on a specific tier, such as alerting based on anomaly detection, which needs Platinum or Enterprise. Elastic's subscriptions page notes that the Platinum tier is no longer available to new customers, so check the current tier list before committing. Ask your vendor or partner to confirm each point in writing.

Who supports the integration after go-live?

Support splits between Elastic, authentik and whoever operates your identity configuration. Elastic supports its cloud service, authentik supports its software and the enterprise edition terms, and your team or a partner owns the mappings between them. After go-live, plan for recurring work when people change roles, when authentik or Elastic releases updates, and when you add domains. DeployOpen offers ongoing support and upgrades as retainers, and most engagements are fixed-scope with the post-launch responsibilities written into the agreement before work starts.

How DeployOpen scopes and delivers authentik SSO for Elastic Cloud

DeployOpen plans and implements authentik inside your own infrastructure, then wires it to your Elastic Cloud organization as a SAML identity provider. The written scope confirms the Enterprise subscription, claimed domains, the Organization owner role mapping and the groups attribute before any configuration starts.

How we scope

  • Confirm the Elastic Cloud subscription tier and Enterprise requirement for SAML SSO before design starts
  • Inventory the email domains you intend to claim and who controls their DNS records
  • Define the groups attribute and which authentik groups map to Elastic Cloud roles
  • Agree in writing whether the engagement covers the authentik hosting work as well

How we build

  • Deploy authentik in your environment and configure the SAML provider and application for Elastic Cloud
  • Create the first role mapping with the Organization owner role so an administrator can always sign in
  • Test sign-in, role assignment and sign-out with a small pilot group before wider rollout
  • Document the mapping rules and the break-glass sign-in path your administrators will rely on

How we hand over

  • Provide a runbook covering claimed domain steps, role mappings, group changes and certificate renewal
  • Walk your identity and platform teams through how new users and groups reach Elastic Cloud
  • Record which settings live in authentik, which live in Elastic Cloud and who owns each change
  • Deliver a written list of open items you must confirm with Elastic and with your own environment

How we support

  • Fixed-scope engagements are agreed in writing with deliverables and timelines before work begins
  • Ongoing support, upgrades and continuous testing are available as a retainer after handover
  • Plan authentik version upgrades and re-test the Elastic Cloud SAML flow after each one
  • Quotes follow from the written scope, so ask for each cost component to be itemized

Sources and further reading

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.