userinfo-endpoint

Implement a UserInfo endpoint returning scope-filtered user claims from access tokens.

7|1|Updated Feb 12, 2023
One-click install
npx skills add https://github.com/hirokazu-kobayashi-koba-hiro/idp-server --skill userinfo-endpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: userinfo-endpoint
Source: https://github.com/hirokazu-kobayashi-koba-hiro/idp-server/tree/main/.claude/skills/userinfo-endpoint
Command: npx skills add https://github.com/hirokazu-kobayashi-koba-hiro/idp-server --skill userinfo-endpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The UserInfo endpoint development guide consolidates how to securely retrieve user information from the access token, applying scope-based filtering and verified_claims support to ensure accurate and privacy-preserving responses for OpenID Connect flows.

Core Features & Use Cases

  • Access Token validation and user info retrieval
  • Scope-based claims filtering across profile, email, phone, and address
  • Support for standard and custom claims prefixed with claims:
  • Verified claims handling (OIDC4IDA) when verified_claims scope is present
  • End-to-end testing integration and alignment with existing validator, verifier, and claims creator components

Quick Start

Begin by examining the UserInfo endpoint flow and implement the required claims logic, then validate changes against the provided end-to-end tests.

Frequently Asked Questions about userinfo-endpoint

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

FAQPage Schema
How do I implement scope-based claims filtering for an OpenID Connect UserInfo endpoint?

Scope-based claims filtering for a UserInfo endpoint works by validating the access token, then returning only the user claims permitted by the requested scopes, such as profile, email, phone, and address. This approach preserves privacy by withholding unauthorized data.

How do I return verified_claims in an OAuth2 UserInfo response?

To return verified_claims in an OAuth2 UserInfo response, your endpoint must check for the presence of the verified_claims scope in the access token. If granted, the endpoint includes identity assurance data alongside standard user claims in the response payload.

Can I add custom claims to the UserInfo endpoint response in a multi-tenant deployment?

Yes, you can add custom claims to the UserInfo endpoint response in a multi-tenant deployment. The implementation supports filtering and returning custom claims prefixed with claims, ensuring tenant-specific data is accurately retrieved based on the validated access token.

What is the role of access token validation in retrieving user info?

Access token validation in retrieving user info ensures that the UserInfo endpoint securely authenticates the request before returning any data. It verifies token integrity and scope permissions, preventing unauthorized access to protected user attributes across multi-tenant environments.

Does the UserInfo endpoint support end-to-end testing integration?

Yes, the UserInfo endpoint implementation explicitly supports end-to-end testing integration. It aligns with existing validator, verifier, and claims creator components to ensure that token validation and scope-aware responses function correctly within the broader server configuration.

Why are my custom claims missing from the OAuth2 UserInfo response?

Custom claims might be missing from the OAuth2 UserInfo response if the required custom claim scopes are not granted to the access token. The endpoint filters claims strictly by scope, meaning unauthorized custom claims prefixed with claims are withheld from the response.