Skip to content

Connect Auth0

Auth0 sends events to Identiguard through a log stream. You create the tenant in Identiguard first, then create the stream in Auth0 with the endpoint and token Identiguard gives you.

Identiguard needs no Auth0 API credentials, and stores none. It creates nothing in the Auth0 tenant.

You need:

  • Access to the Auth0 dashboard with permission to create streams under Monitoring.
  • The admin role in the Identiguard workspace. Members and viewers see Only workspace admins can create tenants. and a disabled Admin Access Required button.
  • The tenant’s canonical domain, such as acme.eu.auth0.com. Do not use a custom domain.
  • A free tenant slot on the plan. See the plan tenant limit.

An Auth0 tenant in Identiguard can have up to three separate endpoints. Each has its own token. Each token is shown once.

Token What it is for When you get it If you lose it
Log stream token Auth0 log events. Every Auth0 tenant has one. On the screen after you create the tenant It cannot be reissued. Delete the tenant and create it again.
Metric stream token API traffic for the Auth0 API metrics page. Optional, beta. At creation, or later from the API Metrics page There is no screen to issue a new one. Contact the product team.
Action logs token Log lines sent by your own Auth0 Actions. Optional. At creation only There is no screen to issue a new one. Contact the product team.
  1. Open the workspace and go to Tenants.
  2. Under Create a tenant, find the Auth0 card (caption Customer identity) and choose Connect. The page Add New Auth0 Tenant opens.
  3. Under Setup Method, choose how you will create the log stream:
    • Manual: Identiguard provides an ingestion endpoint and token. You create the log stream in the Auth0 dashboard.
    • Deploy via Terraform: Identiguard generates a Terraform configuration that you apply yourself.
  4. Under Basic Details, fill in the fields in the table below.
  5. Under Event Subscriptions, check the event types. The recommended set is already ticked when the page opens.
  6. With Deploy via Terraform only: under Obscure Log Stream Data, choose whether Auth0 hides personal data. See Hide personal data.
  7. Optionally tick Set up a metric stream now and Set up Action logs now.
  8. Choose Create Auth0 Tenant. The button reads Creating… while Identiguard works.
Section Field Rules
Setup Method Manual or Deploy via Terraform Manual is selected by default. You cannot change it after creation.
Basic Details Tenant Name Required. 100 characters or fewer. No line breaks or control characters.
Basic Details Customer Name Required. The field suggests customer names already used in the workspace.
Basic Details Auth0 Domain Required. The canonical tenant domain, such as acme.eu.auth0.com. No path, no spaces, not a custom domain. You cannot change it after creation.
Basic Details Environment Required. Production or Development.
Event Subscriptions Subscribed Event Types At least one. The counter shows N of M selected.
Obscure Log Stream Data Obfuscation method, Log data to obscure Terraform only. If you choose a method, tick at least one field.
Metric stream (badge Beta) Set up a metric stream now Optional. Off by default. The form says Can also be set up later.
Metric stream Set up Action logs now Optional. Off by default. It cannot be switched on later from any screen.

There are no Client ID or Client Secret fields for Auth0.

Auth0 publishes 185 log event codes. Each one shows as a description followed by its code in brackets.

  • The recommended set is ticked when the page opens.
  • Select Recommended replaces your whole selection with the recommended set. It leaves out high-volume codes and codes Auth0 does not document.
  • Search event types… filters the list by code or description.
  • Select All ticks every code. While you search, it becomes Select All Visible.
  • Clear All unticks everything.

The list controls what Identiguard keeps. It does not configure the stream in Auth0. With manual setup, select the matching event categories on the stream in Auth0 yourself.

After creation the form is replaced by a setup screen. You are not sent back to the Tenants page.

The screen shows the alert Tenant <name> created. Next, create the stream(s) in Auth0. and Copy these values now. They are shown once.

Panel Values Shown when
Log stream Endpoint URL, Authorization token (shown once) Always
Metric stream (badge Beta) OTLP endpoint URL, Bearer token (shown once) You ticked Set up a metric stream now
Action logs Endpoint URL, Token (shown once), the Action snippet You ticked Set up Action logs now
identiguard.tf The Terraform configuration, with Copy configuration Setup method is Deploy via Terraform
terraform.tfvars (shown once) The ingestion token, with Copy ingestion token Setup method is Deploy via Terraform

Each value has a Copy button. A toast confirms with “<label> copied to clipboard”. When every value is stored, choose Back to Tenants.

  1. In Auth0, go to Monitoring → Streams → Create Stream and choose Custom Webhook.
  2. Enter the Endpoint URL from Identiguard as the payload URL.
  3. Enter the Authorization token from Identiguard as the Authorization header value.
  4. Select the event categories that match the event types you ticked in Identiguard.
  5. Save the stream.
  1. Copy identiguard.tf with Copy configuration and add it to your own Auth0 Terraform project.
  2. Copy the terraform.tfvars value with Copy ingestion token. The token is a Terraform variable. It is not inside identiguard.tf.
  3. Run terraform apply.

You can view identiguard.tf again later on the tenant’s Edit page. The token is never shown again. See Managing tenants.

Sign in to any application on the tenant, then open Dashboard in Identiguard. The sign-in appears under Real-time events within seconds.

Auth0 can obscure chosen fields before events leave the tenant.

With Deploy via Terraform, the section Obscure Log Stream Data appears on the create form. It does not appear for Manual.

  1. Choose an Obfuscation method:
    • None - stream in clear text
    • XXHash - replace with a unique string (Recommended by Auth0)
    • Mask - replace with *****
  2. If you chose XXHash or Mask, tick the fields under Log data to obscure: First name, Last name, Username, Email, Phone, Address. Select all and Clear all tick or untick all six. Tick at least one.

Choose XXHash over Mask if you still want to correlate events for the same (obscured) user. The choice is written into the generated Terraform configuration.

With Manual setup, set Obscure log stream data on the stream in the Auth0 dashboard.

A metric stream adds API traffic to the tenant’s API Metrics page and to the Auth0 API metrics card on the Dashboard. It needs an Auth0 plan that supports Metric Streams, which is typically Enterprise. Auth0’s Terraform provider does not support metric streams, so you always create this stream by hand.

On a new tenant:

  1. On the create form, tick Set up a metric stream now.
  2. After creation, copy the OTLP endpoint URL and the Bearer token (shown once) from the Metric stream panel.
  3. In Auth0, go to Monitoring → Streams → Create Stream and choose Metric Stream of type HTTP.
  4. Enter the OTLP endpoint URL.
  5. Choose Bearer Token as the authentication method and paste the token. Paste the token only. Auth0 adds the word Bearer itself.

On an existing tenant, the setup is on the API Metrics page, not on the Edit page. See Auth0 API metrics.

There is no screen to switch a metric stream off or to issue a new token.

Log lines from your own Auth0 Actions can arrive in Identiguard. Each line becomes an event.

  1. On the create form, tick Set up Action logs now.
  2. After creation, copy the Endpoint URL, the Token (shown once) and the Action snippet from the Action logs panel.
  3. In Auth0, go to Actions → Library and open the Action you want to log from.
  4. Add the token as a secret named IDENTIGUARD_TOKEN.
  5. Add the snippet to the Action, and call it where you want a log line.

What to know before you use it:

  • Levels. A line sent at the error level opens an Identiguard incident, so keep error for real failures. Lines at the info level are not accepted until that level is switched on, and there is no screen for that.
  • Personal data. The setup screen states: “Identiguard stores whatever your Action sends. Auth0’s “Obscure log stream data” setting does not apply to this endpoint, and Identiguard cannot mask or filter these lines. It is the integrator’s responsibility to ensure no personal data is placed in the message or data fields.” Make sure the person who writes the Action knows this.
  • Delivery is best effort. Sign-ins never wait for Identiguard. A line that is still being sent when the Action finishes is lost.

One Auth0 tenant can be used in one Identiguard trial only. If the tenant was already used in another trial, Identiguard still creates it, but does not accept its events. The Tenants page then shows the banner Some tenants are not being monitored on this trial with the tenant’s name. See Tenant health.

Field errors show in red under the field. Other errors show as a red toast. A toast that starts with Failed to create tenant: comes from the server.

What you see Why What to do
“Only workspace admins can create tenants.” and a disabled Admin Access Required button Your role is member or viewer Ask a workspace admin to create the tenant.
“Tenant name cannot be empty”, “Tenant name must be 100 characters or fewer” or “Tenant name cannot contain line breaks or control characters” The tenant name breaks a rule Fix the name.
“Customer name is required” Customer Name is blank Enter the customer.
“Auth0 domain is required” Auth0 Domain is blank Enter the canonical domain.
“Enter the canonical Auth0 tenant domain (e.g., acme.eu.auth0.com)” The domain has a path or a space, or is not a domain Enter the canonical domain only, not a custom domain and not a URL.
“Environment is required” No environment is chosen Choose Production or Development.
“At least one event type must be selected” Nothing is ticked Tick at least one type, or choose Select Recommended.
“Invalid event type submitted” The page sent a code that is not on the allowed list Reload the page and select again.
“Select at least one field to obscure, or choose None” Terraform setup. You chose XXHash or Mask but ticked no field. Tick at least one field, or choose None - stream in clear text.
What you see Why What to do
“Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” The workspace is at its plan tenant limit Delete a tenant you no longer need, or upgrade the plan. See Plans and billing.
“The tenant was created, but no ingestion endpoint was returned. Delete the tenant and try again.” The tenant was saved but its endpoint or token is missing Delete that tenant on the Tenants page and create it again.
“Failed to create tenant: Failed to store Auth0 tenant.” The tenant could not be saved Try again. Escalate if it repeats.
“Forbidden: You do not have permission to create tenants.” Your role changed while the page was open Ask a workspace admin.
“Failed to create tenant: Bad Request” The server rejected the form Check every field again. Escalate if it continues.
“Failed to create tenant: API error” or “An unexpected error occurred: …” An unexpected error Try again, then escalate to the product team.
“Failed to create tenant: Server configuration error…” A platform problem Escalate to a platform operator.
“Could not copy; select the text and copy it manually.” The browser blocked access to the clipboard Select the value with the mouse and copy it by hand.
What you see Why What to do
No events after you create the stream, and no message The token was pasted wrongly, the stream is paused in Auth0, or the event is of a type that is not ticked in Identiguard In Auth0, check the stream’s health and its Authorization value. In Identiguard, check the ticked types under Event Subscriptions.
You lost the log stream token The token is shown once and cannot be reissued Delete the tenant and create it again. See Rotate credentials.
Banner Some tenants are not being monitored on this trial This Auth0 tenant was already used in another Identiguard trial. Its events are not accepted. Choose Go to the Billing page and choose a plan, or contact Identiguard support.
API Metrics shows Stale or “nothing received yet” The metric stream is not delivering See Auth0 API metrics.
An Action’s lines do not arrive The IDENTIGUARD_TOKEN secret is missing or wrong, the line is at the info level, or the line was lost when the Action finished Check the secret on the Action. Send a test line at the warn level.
Events keep arriving in Auth0’s stream health as failures after you deleted the tenant The stream in Auth0 still points at a revoked endpoint Delete the stream in Auth0, or run terraform destroy.