Google OIDC Well Known

Published
Length
3 min read

Luis Felipe Dias

All posts

The google oidc well known endpoint shares public sign-in settings for your apps. Your app reads this JSON file to find login links and public keys. Teams use this file so they do not hardcode login paths in code. Still, linking an identity provider only proves who a user is at login. If that user gets a broad role, they can still run risky commands. How the google oidc well known endpoint works OpenID Connect uses a standard discovery document to share identity rules across services. Google

K8s OIDC Authentication: the complete guide

Architecture patterns, implementation strategies, and security best practices. Delivered to your inbox.

Free white paper. No spam. Unsubscribe anytime.

The google oidc well known endpoint shares public sign-in settings for your apps. Your app reads this JSON file to find login links and public keys. Teams use this file so they do not hardcode login paths in code. Still, linking an identity provider only proves who a user is at login. If that user gets a broad role, they can still run risky commands.

How the google oidc well known endpoint works

OpenID Connect uses a standard discovery document to share identity rules across services. Google hosts this public document at a fixed web path for all apps. When your app starts, it sends a simple web request to that path. The response returns a structured map of endpoints and supported security algorithms.

First, the file lists the exact URL where users go to log in. Second, it gives the token URL where your app trades codes for tokens. Third, it shares a link to the public keys that sign those tokens. Your app fetches those public keys to check the signature on each token.

Google rotates its signing keys on a regular schedule to keep accounts safe. Because your app reads the discovery link, it finds new keys right away. Engineers do not need to update key files by hand when keys change. The discovery response also lists the user claims that your app can request. Standard claims include the user email address, unique subject ID, and profile name.

How teams set up Google OIDC discovery

To set this up, an admin first creates a client in Google Cloud. That step gives the team a unique client ID and a client secret. Next, the admin sets the allowed callback URLs for the internal tool. Then, the engineer points the app login library to the Google issuer URL.

Most modern auth libraries add the standard discovery path to the issuer URL. During login, the library reads the JSON document and caches the key paths. When a user signs in, Google sends back a signed identity token. The library checks the token issuer, the audience ID, and the expiration time. If every check passes, the app lets the user into the system.

K8s OIDC Authentication: architecture patterns and best practices

Continue reading? Get the full guide.

Free. No spam. Unsubscribe anytime.

What Google OIDC solves and what it leaves open

This discovery flow solves a major operational problem for engineering and security teams. It removes static key management and centralizes user login inside your workspace directory. When someone leaves the company, disabling their Google account blocks new app logins. Teams also get a single place to enforce two-factor checks at login time.

Still, OpenID Connect only checks identity at the start of a user session. It does not inspect what the user does after they log in. Once inside a database or server, the session runs with a fixed role. If an engineer maps to an admin database role, they can drop tables. A valid identity token also cannot mask sensitive fields in query results. If a table holds emails, phone numbers, or card numbers, raw rows return. Identity checks verify the person, but they do not govern individual commands in flight.

Check database and API queries on the wire

Identity tools, roles, and network rules decide who opens a session. Setup alone cannot check what each query does or mask sensitive values in a response once a session starts. When workflows touch Postgres, MySQL, SQL Server, MongoDB, ClickHouse, Kubernetes APIs, SSH, or internal HTTP APIs, hoop.dev runs beside those services as an open-source proxy, a sidecar for your Postgres or API. It inspects requests coming in and results going back on the wire.

Your login details and client tools stay as they are while hoop.dev guardrails refuse bad deletes or drops before they run. On responses, hoop.dev data masking rewrites matched sensitive values in memory. Furthermore, hoop.dev holds SOC 2 Type II, is MIT licensed, and writes every query and decision to an audit trail that generates evidence for HIPAA, GDPR, and PCI DSS. See the source on GitHub.

Frequently asked questions

Why should apps cache the Google OIDC discovery response?

Fetching the discovery file on every login adds extra network delay and risk. Caching the response in memory keeps logins fast and handles brief network drops.

What happens when Google rotates its public signing keys?

Google publishes new keys at the keys URI listed in the discovery file. Well-built auth libraries fetch fresh keys when they see an unknown key ID.

Does Google OIDC control database queries after a user logs in?

No, OIDC only proves user identity and issues a token at login time. It cannot inspect SQL statements, block drop commands, or rewrite sensitive query results.

Save the open-source gateway.

hoop is MIT-licensed infrastructure for controlling how AI agents reach production data. Star hoophq/hoop so you can inspect it, deploy it, or share it when your team starts governing agent access.