:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from typing import Optional, cast
from products.warehouse_sources.sources.auth0._config import Auth0SourceConfig
from products.warehouse_sources.sources.auth0.auth0 import (
HOST_NOT_ALLOWED_ERROR,
PAGINATION_STALLED_ERROR,
Auth0ResumeConfig,
auth0_source,
validate_credentials as validate_auth0_credentials,
)
from products.warehouse_sources.sources.auth0.settings import ENDPOINTS, INCREMENTAL_FIELDS
from products.warehouse_sources.sources.sdk import (
CanonicalDescriptions,
DataWarehouseSourceCategory,
ExternalDataSourceType,
FieldType,
ReleaseStatus,
ResumableSource,
ResumableSourceManager,
SourceConfig,
SourceFieldInputConfig,
SourceFieldInputConfigType,
SourceInputs,
SourceRegistry,
SourceResponse,
SourceSchema,
build_endpoint_schemas,
detect,
)
@SourceRegistry.register
class Auth0Source(ResumableSource[Auth0SourceConfig, Auth0ResumeConfig]):
codebase_detection = detect(
env=(
"^AUTH0_",
"^VITE_AUTH0_",
"^NUXT_AUTH0_",
"^NEXT_PUBLIC_AUTH0_DOMAIN$",
"^NEXT_PUBLIC_AUTH0_CLIENT_ID$",
"^REACT_APP_AUTH0_DOMAIN$",
"^REACT_APP_AUTH0_CLIENT_ID$",
"^MCP_AUTH0_CLIENT_ID$",
"^MCP_AUTH0_CLIENT_SECRET$",
"^MCP_AUTH0_EXCHANGE_SCOPE$",
"^API_AUTH0_AUDIENCE$",
),
script_hosts=("cdn.auth0.com", "cdn.us.auth0.com", "cdn.eu.auth0.com", "cdn.au.auth0.com", "cdn.jp.auth0.com"),
npm=(
"auth0",
"@auth0/auth0-react",
"@auth0/nextjs-auth0",
"@auth0/auth0-spa-js",
"auth0-js",
"@auth0/auth0-angular",
"@auth0/auth0-vue",
"express-openid-connect",
"react-native-auth0",
"passport-auth0",
"@auth0/auth0-auth-js",
"@auth0/auth0-api-js",
"@auth0/auth0-server-js",
"@auth0/auth0-fastify",
"@auth0/auth0-fastify-api",
"@auth0/auth0-hono",
"@auth0/auth0-nuxt",
"@auth0/auth0-express",
"@auth0/auth0-express-api",
"@auth0/auth0-react-router",
"@auth0/auth0-tanstack-start-react",
"@auth0/auth0-acul-js",
"@auth0/auth0-acul-react",
"@auth0/ai",
"@auth0/ai-vercel",
"@auth0/ai-langchain",
"@auth0/ai-llamaindex",
"@auth0/ai-genkit",
"@auth0/ai-cloudflare",
"@auth0/ai-redis",
"@auth0/ai-components",
"@auth0/auth0-cloudflare-agents-api",
"@auth0/myorganization-js",
"@auth0/myaccount-js",
"@auth0/universal-components-react",
"@auth0/universal-components-core",
"@auth0/actions",
"@auth0/auth0-mcp-server",
"@auth0/auth0-checkmate",
"@auth0/cordova",
"auth0-lock",
"auth0-lock-passwordless",
"auth0-guardian-js",
"auth0-deploy-cli",
"express-oauth2-jwt-bearer",
"angular-auth0",
"angular-lock",
"auth0-angular",
"react-native-lock",
"fastify-auth0-verify",
"remix-auth-auth0",
),
pypi=(
"auth0-python",
"auth0-fastapi",
"auth0-fastapi-api",
"auth0-server-python",
"auth0-api-python",
"auth0-ai",
"auth0-ai-langchain",
"auth0-ai-llamaindex",
"myorganization-python",
),
cocoapods=("Auth0", "Lock", "Guardian"),
composer=(
"auth0/auth0-php",
"auth0/login",
"auth0/symfony",
"auth0/wordpress",
"auth0/jwt-auth-bundle",
"auth0/auth0_drupal",
),
go=(
"github.com/auth0/go-auth0",
"github.com/auth0/go-jwt-middleware",
"github.com/auth0/myorganization-go",
"github.com/go-auth0/auth0",
"gopkg.in/auth0.v5",
"gopkg.in/auth0.v4",
),
hex=("ueberauth_auth0", "auth0_ex", "prima_auth0_ex"),
maven=(
"com.auth0:auth0",
"com.auth0.android:auth0",
"com.auth0:auth0-spring-security-api",
"com.auth0:mvc-auth-commons",
"com.auth0:auth0-api-java",
"com.auth0:auth0-springboot-api",
"com.auth0:myorganization-java",
"com.auth0:myaccount-java",
"com.auth0:guardian",
"com.auth0:auth0-servlet",
"com.auth0:auth0-spring-mvc",
"com.auth0:auth0-spring-security-mvc",
"com.auth0:spring-security-auth0",
"com.auth0.android:lock",
"com.auth0.android:guardian",
"com.auth0.android:lock-passwordless",
"com.auth0.android:core",
"com.auth0.kmp:auth0",
"com.auth0.kmp:auth0-core",
"com.auth0.kmp:auth0-authentication",
"com.auth0.kmp:auth0-webauth",
"com.auth0.kmp:auth0-credentials",
"com.auth0.kmp:auth0-myaccount",
"com.auth0.universalcomponents:universal-components",
),
pub=("auth0_flutter", "auth0_flutter_platform_interface"),
rubygems=("auth0", "omniauth-auth0"),
swiftpm=(
"github.com/auth0/auth0.swift",
"github.com/auth0/lock.swift",
"github.com/auth0/guardian.swift",
"github.com/auth0/ui-components-ios",
),
)
lists_tables_without_credentials = True # static endpoint catalog — safe for public docs
supported_versions = ("v2",)
default_version = "v2"
api_docs_url = "https://auth0.com/docs/api/management/v2"
@property
def source_type(self) -> ExternalDataSourceType:
return ExternalDataSourceType.AUTH0
@property
def connection_host_fields(self) -> list[str]:
# `auth0_domain` is where the stored client secret is sent; retargeting it must re-require it.
return ["auth0_domain"]
@property
def get_source_config(self) -> SourceConfig:
return SourceConfig(
name=ExternalDataSourceType.AUTH0,
category=DataWarehouseSourceCategory.ENGINEERING___MONITORING,
label="Auth0",
releaseStatus=ReleaseStatus.GA,
keywords=["okta", "identity", "sso", "authentication", "ciam"],
caption="""Enter your Auth0 tenant domain and a machine-to-machine application's credentials to pull your users, tenant logs, and tenant configuration into the PostHog Data warehouse.
In the Auth0 dashboard go to **Applications > Applications**, create a **Machine to Machine** application, and authorize it for the **Auth0 Management API**. Grant the read scopes for the tables you want to sync: `read:users`, `read:logs`, `read:clients`, `read:connections`, `read:roles`, `read:organizations`, `read:resource_servers`, `read:actions`, `read:log_streams`, `read:organization_members`, `read:organization_member_roles`, `read:sessions`.
Use your canonical tenant domain (for example `your-tenant.us.auth0.com`), not a custom domain. Auth0 only issues Management API tokens for the canonical one.""",
iconPath="/static/services/auth0.png",
docsUrl="https://posthog.com/docs/cdp/sources/auth0",
fields=cast(
list[FieldType],
[
SourceFieldInputConfig(
name="auth0_domain",
label="Auth0 domain",
type=SourceFieldInputConfigType.TEXT,
required=True,
placeholder="your-tenant.us.auth0.com",
secret=False,
),
SourceFieldInputConfig(
name="client_id",
label="Client ID",
type=SourceFieldInputConfigType.TEXT,
required=True,
placeholder="",
secret=False,
),
SourceFieldInputConfig(
name="client_secret",
label="Client secret",
type=SourceFieldInputConfigType.PASSWORD,
required=True,
placeholder="",
secret=True,
),
],
),
)
def get_non_retryable_errors(self) -> dict[str, str | None]:
return {
"401 Client Error": "Auth0 rejected the credentials. Check the machine-to-machine application's client ID and secret, then reconnect.",
"403 Client Error": "Your Auth0 application is missing a read scope for this table. Grant it on the Management API and try again.",
HOST_NOT_ALLOWED_ERROR: "The Auth0 domain is not allowed. Use your tenant's canonical Auth0 domain.",
PAGINATION_STALLED_ERROR: "Auth0 could not page past its 1000-result limit because too many rows share the same timestamp.",
}
def get_retryable_errors(self) -> set[str]:
# `fetch` (auth0.py) already retries 429 via the tracked session's BoundedRetry, honoring
# Retry-After; if that budget still exhausts, Temporal retries the whole activity, so the
# failure is self-recovering rather than a bug to page on.
return {"429 Client Error"}
def get_canonical_descriptions(self) -> CanonicalDescriptions:
from products.warehouse_sources.sources.auth0.canonical_descriptions import CANONICAL_DESCRIPTIONS
return CANONICAL_DESCRIPTIONS
def get_schemas(
self,
config: Auth0SourceConfig,
team_id: int,
with_counts: bool = False,
names: list[str] | None = None,
force_refresh: bool = False,
api_version: str | None = None,
) -> list[SourceSchema]:
# Users are mutable and the window's inclusive lower bound re-reads its boundary rows, so
# merge is the only safe incremental mode — append would duplicate rows.
return build_endpoint_schemas(ENDPOINTS, INCREMENTAL_FIELDS, names, merge_only=ENDPOINTS)
def validate_credentials(
self,
config: Auth0SourceConfig,
team_id: int,
schema_name: Optional[str] = None,
api_version: str | None = None,
) -> tuple[bool, str | None]:
return validate_auth0_credentials(
domain=config.auth0_domain,
client_id=config.client_id,
client_secret=config.client_secret,
api_version=self.resolve_api_version(api_version),
schema_name=schema_name,
team_id=team_id,
)
def get_resumable_source_manager(self, inputs: SourceInputs) -> ResumableSourceManager[Auth0ResumeConfig]:
return ResumableSourceManager[Auth0ResumeConfig](inputs, Auth0ResumeConfig)
def source_for_pipeline(
self,
config: Auth0SourceConfig,
resumable_source_manager: ResumableSourceManager[Auth0ResumeConfig],
inputs: SourceInputs,
) -> SourceResponse:
return auth0_source(
domain=config.auth0_domain,
client_id=config.client_id,
client_secret=config.client_secret,
endpoint=inputs.schema_name,
api_version=self.resolve_api_version(inputs.api_version),
logger=inputs.logger,
resumable_source_manager=resumable_source_manager,
team_id=inputs.team_id,
should_use_incremental_field=inputs.should_use_incremental_field,
incremental_field=inputs.incremental_field,
db_incremental_field_last_value=inputs.db_incremental_field_last_value
if inputs.should_use_incremental_field
else None,
)