Skip to content

Document that the Google OpenID auth backend matches users by their (mutable) email#68391

Open
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:docs-google-openid-email-identity-lifecycle
Open

Document that the Google OpenID auth backend matches users by their (mutable) email#68391
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:docs-google-openid-email-identity-lifecycle

Conversation

@potiuk

@potiuk potiuk commented Jun 11, 2026

Copy link
Copy Markdown
Member

The Google OpenID API auth backend (airflow.providers.google.common.auth_backend.google_openid) authenticates a request by matching the verified email claim of the Google ID token against an existing Airflow user, and does not consult the immutable sub claim. Because email addresses are mutable (corporate reassignment, domain recycling), this documents that the email-to-user mapping is part of the deployment's identity lifecycle:

  • deprovision (or re-map) the Airflow user whenever its email is reassigned, and
  • don't recycle an address to a different identity while an Airflow account is still mapped to it;
  • restricting google_oauth2_audience to your own deployment keeps tokens minted for unrelated audiences out of scope.

Docs-only change to the existing google-openid.rst (this backend is an Airflow 2.x mechanism).

Was generative AI tooling used to co-author this PR?
  • Yes — Claude Opus 4.8 (1M context)

Generated-by: Claude Opus 4.8 (1M context) following the guidelines at
https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:providers kind:documentation provider:google Google (including GCP) related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant