Integrate Login.gov as a SAML 2.0 identity provider for a government service, as an alternative to Login.gov's OpenID Connect integration
domain: developers.login.gov · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Note that Login.gov itself recommends OpenID Connect over SAML for new integrations, so confirm SAML is required by your service's existing stack before proceeding.
Configure your service provider with Login.gov's SingleSignOnService and SingleLogoutService endpoints, using the year-suffixed URLs (e.g. /api/saml/auth2026, /api/saml/logout2026) and the persistent v4-UUID NameID format.
Retrieve Login.gov's IdP metadata, or its signing certificate directly, so your app can validate the signature on SAML responses; pulling from the metadata endpoint is preferred since it avoids manual certificate re-uploads.
Use a maintained SAML library for your language rather than hand-rolling XML signature validation, per Login.gov's own guidance that the standard is complex to implement correctly.
Test the full authentication and logout flow against the identity sandbox environment using Login.gov's open-source example client before requesting Partner Portal production credentials.
Track Login.gov's annual certificate rotation: new year-suffixed endpoints and signing certificates are issued each spring with about a month of overlap, and old endpoints are retired, so plan a migration window rather than hardcoding a single year's URLs.
Known gotchas
The year-suffixed endpoint pattern changes annually (auth2025 to auth2026, etc.); hardcoding a single year's SSO, logout, or metadata URL will break after the certificate rotation window closes.
Do not upload Login.gov's own signing certificate into the Partner Portal — that certificate is for your app to validate Login.gov's responses, not for Login.gov to validate yours.
SAML is explicitly the secondary, not preferred, integration path — new government-service integrations lacking a hard SAML requirement should default to OIDC per Login.gov's own developer guidance.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?