id
A tool for generating OIDC identities
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and solves a real security problem (eliminating long-lived secrets in CI/CD). Install it when you need to retrieve OIDC tokens in a supported environment; skip it if your workloads run outside the listed platforms or if you manage credentials through other means.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or newer; only produces tokens when running in a supported CI/CD or cloud environment (GitHub Actions, Google Cloud, Buildkite, GitLab, CircleCI).
- Low friction: pure Python wheel with a single runtime dependency (urllib3).
- Actively maintained with recent commits and Production/Stable status; requires Python 3.9 or newer.
License · maintenance · safety
permissive license (permissive) — Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution in both open-source and commercial projects with minimal restrictions.
last release 2026-02-04 (191 days) · last repo commit 2026-08-02 · 17 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 34,431,432 downloads/mo, #759 on PyPI
Alternatives
Verify before relying
pip install id
from id import detect_credential
token = detect_credential(audience='https://example.com')
# Or via CLI:
python -m id --help- Whether the package supports additional cloud providers beyond those listed in the description.
- Performance characteristics when retrieving tokens from high-latency or rate-limited environments.
- Whether AmbientCredentialError includes actionable diagnostic information for troubleshooting token retrieval failures.
What it is and what it does
id is a Python tool for retrieving OIDC identity tokens from the ambient environment in which it runs. Instead of managing static credentials, it detects whether your code is executing in a supported CI/CD platform or cloud service (GitHub Actions, Google Cloud, Buildkite, GitLab, CircleCI) and automatically retrieves the corresponding OIDC token for that environment. The package exposes both a CLI interface and a Python API via the `detect_credential()` function, which takes an audience parameter and returns the token string or None if no supported environment is detected.
The primary use case is workload identity federation: enabling applications running in CI/CD pipelines or cloud infrastructure to authenticate to external services without storing long-lived API keys or secrets. It relies on urllib3 for HTTP operations and is designed to be lightweight and zero-configuration—if your code runs in a recognized environment, the token is available immediately.
Use it for
- Authenticate GitHub Actions workflows to external services using OIDC without storing repository secrets.
- Enable Google Cloud workloads (Cloud Run, GKE, Compute Engine) to obtain identity tokens for cross-service authentication.
- Retrieve GitLab CI tokens from environment variables for secure pipeline-to-service communication.
- Implement workload identity in Buildkite or CircleCI pipelines for federated authentication.
- Build deployment tools that automatically adapt to the hosting environment without manual credential configuration.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has no known vulnerabilities, low install friction, and solves a real security problem (eliminating long-lived secrets in CI/CD). Install it when you need to retrieve OIDC tokens in a supported environment; skip it if your workloads run outside the listed platforms or if you manage credentials through other means.
Install
id on PyPI
Before you install
Low friction: pure Python wheel with a single runtime dependency (urllib3). Actively maintained with recent commits and Production/Stable status; requires Python 3.9 or newer.
Requires Python 3.9 or newer; only produces tokens when running in a supported CI/CD or cloud environment (GitHub Actions, Google Cloud, Buildkite, GitLab, CircleCI).
License in practice
Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution in both open-source and commercial projects with minimal restrictions.
Quickstart
pip install id
from id import detect_credential
token = detect_credential(audience='https://example.com')
# Or via CLI:
python -m id --helpVerify before relying
- Whether the package supports additional cloud providers beyond those listed in the description.
- Performance characteristics when retrieving tokens from high-latency or rate-limited environments.
- Whether AmbientCredentialError includes actionable diagnostic information for troubleshooting token retrieval failures.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageurllib3 |
| Maintenance | Actively maintained 191 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 34,431,432 / month, #759 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: SecurityTopic :: Security :: Cryptography |
Evidence: id-1.6.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “OIDC token generation”
- idGenerates OIDC identity tokens by automatically detecting the current…
- vercel-oidcRetrieves, decodes, and verifies Vercel OIDC tokens for Python…
- django-oidc-providerProvides OpenID Connect and OAuth 2.0 server endpoints,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also ssh-import-id · cybrid-api-id-python · sigstore · ci-info · oidc-provider-mock · django-oidc-provider · vercel-oidc · flask-oidc · dash-auth · mozilla-django-oidc