> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Log in with SAML SSO

> Log in to a Honeycomb Team configured for SAML SSO, whether you are a new user or an existing user switching login methods.

<Badge className="hny-badge-enterprise">Ent</Badge><Badge className="hny-badge-pro">Pro</Badge>

<Info>
  This feature is available as part of the [Honeycomb Pro and Enterprise plans](https://www.honeycomb.io/pricing/).
</Info>

Honeycomb Teams can require authentication through a SAML Identity Provider (IdP).
This guide walks you through logging in to a SAML-configured Honeycomb Team.

## Before you begin

Before you log in, make sure you have the following:

* An account in your team's SAML IdP, such as Okta or Microsoft Entra ID. If you need help determining which IdP your team uses, contact your Team Owner.
* Access to the email address associated with your IdP account.

<Note>
  You don't need an existing Honeycomb account.
  If you don't have one, Honeycomb creates one for you during the login process.
</Note>

## Logging in

<Steps titleSize="h3">
  <Step title="Log in to your IdP">
    To reach your Honeycomb team's login page, you must first log in to your IdP.
    Choose the option that works best for you.

    <Tabs>
      <Tab title="Direct login URL">
        If you know your team's slug, go directly to your team's SAML login page:

        * **US:** `https://ui.honeycomb.io/login/sso/{team_slug}`
        * **EU:** `https://ui.eu1.honeycomb.io/login/sso/{team_slug}`

        For example, to log in to a US team with the slug `hny`, go to `https://ui.honeycomb.io/login/sso/hny`.

        If the team is configured for SAML, the page redirects to the team's SAML IdP.
      </Tab>

      <Tab title="Company IdP dashboard">
        Log in to your company's IdP directly (for example, `yourcompany.okta.com`) and select the `Honeycomb` tile for your team.
      </Tab>
    </Tabs>

    If you need help choosing an option or locating Honeycomb in your IdP dashboard, contact your Team Owner.
  </Step>

  <Step title="Log in to Honeycomb">
    Once you have logged in to your IdP, your login flow depends on whether you are a new Honeycomb user or an existing one.

    <Tabs>
      <Tab title="New user">
        If you are new to Honeycomb, Honeycomb asks you to verify your email address before creating your account.
        To verify:

        1. Check your email for an account activation code.
                   <Tip>
                     The verification email may take a few minutes to arrive.
                     Check your spam folder if you don't see it.
                   </Tip>
        2. Copy the verification code from the email.
        3. Enter the code on the Honeycomb landing page.
        4. Select **Submit**.

        Honeycomb redirects you to your team's home page.
      </Tab>

      <Tab title="Existing user - account already linked">
        If you have logged in with this SAML IdP before and already linked your Honeycomb account, Honeycomb redirects you directly to your team's home page.
      </Tab>

      <Tab title="Existing user - account not yet linked">
        If you have a Honeycomb account not yet linked to this SAML IdP, the flow depends on whether you are currently logged in to Honeycomb.

        **If you are currently logged in to Honeycomb:**

        Honeycomb displays a confirmation page asking you to link your account to this SAML IdP.

        <Note>
          A Honeycomb account can be linked to more than one SAML IdP, so linking this account won't affect any existing IdP connections.
        </Note>

        1. Review the information on the page before proceeding:

           | Field                    | Description                                                                                                                                               |
           | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
           | `SAML Identity`          | Identifier your SAML provider uses to identify your account. Often your email address, but may be another form of identifier. Useful for troubleshooting. |
           | `Issuer (SAML Provider)` | Identifier for the SAML provider you logged in with.                                                                                                      |
           | `Honeycomb Account`      | Email address associated with your currently logged-in Honeycomb account.                                                                                 |
           | `Team`                   | Team for which the IdP is configured. Honeycomb adds you to this team after you link your account.                                                        |
        2. Choose your path:
           * If everything looks correct, select **Link account** to complete the process.
           * If something doesn't look right or you don't want to link this account, select **Cancel**.

        **If you are logged out of Honeycomb:**

        Honeycomb recognizes your email address and asks you to verify ownership before linking your account.
        To verify:

        1. Check your email for an account activation code.
                   <Tip>
                     The verification email may take a few minutes to arrive.
                     Check your spam folder if you don't see it.
                   </Tip>
        2. Copy the verification code from the email.
        3. Enter the code on the Honeycomb landing page.
        4. Select **Submit**.

        Honeycomb redirects you to the home page for your team.
      </Tab>
    </Tabs>
  </Step>
</Steps>