userinfo.md

title	UserInfo Endpoint
description	Reference documentation for the UserInfo endpoint, which allows retrieval of authenticated user claims using a valid access token.
date	2020-09-10 08:22:12 +0200
sidebar	order 4
redirect_from	/identityserver/v5/reference/endpoints/userinfo/ /identityserver/v6/reference/endpoints/userinfo/ /identityserver/v7/reference/endpoints/userinfo/

The UserInfo endpoint can be used to retrieve claims about a user ( see spec).

The caller needs to send a valid access token. Depending on the granted scopes, the UserInfo endpoint will return the mapped claims (at least the openid scope is required).

GET /connect/userinfo
Authorization: Bearer <access_token>

HTTP/1.1 200 OK
Content-Type: application/json

{
    "sub": "248289761001",
    "name": "Bob Smith",
    "given_name": "Bob",
    "family_name": "Smith"
}

.NET Client Library

You can use the Duende IdentityModel client library to programmatically interact with the protocol endpoint from .NET code.

using IdentityModel.Client;

var client = new HttpClient();

var response = await client.GetUserInfoAsync(new UserInfoRequest
{
    Address = disco.UserInfoEndpoint,
    Token = token
});