oidc-userinfo-endpoint

Implement a TLS-secured OpenID Connect UserInfo endpoint validating Bearer access tokens and returning scope-based user claims.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/maronnjapan/maronn-openid-provider --skill oidc-userinfo-endpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oidc-userinfo-endpoint
Source: https://github.com/maronnjapan/maronn-openid-provider/tree/main/.claude/skills/oidc-userinfo-endpoint
Command: npx skills add https://github.com/maronnjapan/maronn-openid-provider --skill oidc-userinfo-endpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenID Connect UserInfo Endpoint implementation guide to securely retrieve user claims based on access tokens and scopes, enabling compliant Basic OP certification and user data exposure.

Core Features & Use Cases

  • TLS-secured UserInfo endpoint (https) with Bearer token authentication and mandatory sub claim.
  • Scope-based claims support for openid, profile, email, address, and phone.
  • Alignment with OpenID Connect Core 1.0 Section 5.3 requirements for certification and interoperability.
  • Use Case: when implementing user info retrieval in a provider and validating tokens.

Quick Start

Configure your OpenID provider to expose a TLS-secured /userinfo endpoint that validates access tokens and returns the appropriate user claims.

Frequently Asked Questions about oidc-userinfo-endpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement an OIDC UserInfo endpoint that returns user claims?

To implement an OIDC UserInfo endpoint, you need to configure a TLS-secured HTTPS route that authenticates requests using Bearer access tokens and returns scope-filtered user claims.

What claims should a UserInfo endpoint return for OpenID Connect scopes?

A UserInfo endpoint returns claims based on requested scopes, providing subject, profile, email, address, and phone information when the corresponding openid, profile, email, address, or phone scopes are granted.

How do I validate access tokens at the OIDC UserInfo endpoint?

Validating access tokens at the UserInfo endpoint requires enforcing Bearer authentication, ensuring the token is active, and aligning the returned sub claim exactly with the subject identifier in the ID Token.

Do I need TLS for an OpenID Connect Basic OP UserInfo endpoint?

Yes, TLS is mandatory for a Basic OP UserInfo endpoint to secure token transmission and protect sensitive user claims during the authentication and data retrieval process.

Why must the sub claim in the UserInfo response match the ID Token?

The sub claim in the UserInfo response must match the ID Token to prevent subject mismatch vulnerabilities, ensuring the authenticated user data securely aligns with the issued token context.

What is needed for OpenID Connect Basic OP certification for a UserInfo endpoint?

Basic OP certification requires the UserInfo endpoint to comply with OpenID Connect Core 1.0 Section 5.3, enforcing TLS, Bearer authentication, sub alignment, and scope-based claims filtering.