com.nimbusds.openid.connect.provider.spi.tokens

Class MutableAccessTokenAuthorization

java.lang.Object

com.nimbusds.openid.connect.provider.spi.tokens.MutableAccessTokenAuthorization

All Implemented Interfaces:

AccessTokenAuthorization

public final class MutableAccessTokenAuthorization
extends Object
implements AccessTokenAuthorization

Mutable access token authorisation.

Constructor Summary

Constructors

Constructor and Description
MutableAccessTokenAuthorization() Creates a new empty mutable access token authorisation.
MutableAccessTokenAuthorization(AccessTokenAuthorization source) Creates a new mutable access token authorisation from the specified one.

Method Summary

Modifier and Type	Method and Description
com.nimbusds.oauth2.sdk.id.Actor	getActor() Returns the token actor, in impersonation and delegation scenarios.
List<com.nimbusds.oauth2.sdk.id.Audience>	getAudienceList() Returns the audience list of the token, which may be the logical names of the intended resource servers.
Set<String>	getClaimNames() Returns the names of the consented OpenID claims to be accessed at the UserInfo endpoint.
net.minidev.json.JSONObject	getClaimsData() Returns the optional claims fulfillment data.
List<com.nimbusds.langtag.LangTag>	getClaimsLocales() Returns the preferred locales for the consented OpenID claims.
com.nimbusds.oauth2.sdk.auth.X509CertificateConfirmation	getClientCertificateConfirmation() Returns the client X.509 certificate confirmation (SHA-256 thumbprint) for mutual TLS.
com.nimbusds.oauth2.sdk.id.ClientID	getClientID() Returns the identifier of the client to which the token is issued.
net.minidev.json.JSONObject	getData() Returns the optional data for the token.
Instant	getExpirationTime() Returns the expiration time of the token.
com.nimbusds.oauth2.sdk.id.Issuer	getIssuer() Returns the issuer of the token.
Instant	getIssueTime() Returns the issue time of the token.
com.nimbusds.oauth2.sdk.id.JWTID	getJWTID() Returns the JSON Web Token (JWT) identifier of the token.
Map<String,Object>	getOtherTopLevelParameters() Returns a map of other top-level parameters.
net.minidev.json.JSONObject	getPresetClaims() Returns the preset OpenID claims to be included in the UserInfo response.
com.nimbusds.oauth2.sdk.Scope	getScope() Returns the scope of the token.
com.nimbusds.oauth2.sdk.id.Subject	getSubject() Returns the token subject.
String	toString()
MutableAccessTokenAuthorization	withActor(com.nimbusds.oauth2.sdk.id.Actor act) Sets the token actor, in impersonation and delegation scenarios.
MutableAccessTokenAuthorization	withAudienceList(List<com.nimbusds.oauth2.sdk.id.Audience> audList) Sets the audience list of the token, which may be the logical names of the intended resource servers.
MutableAccessTokenAuthorization	withClaimNames(Set<String> claimNames) Sets the names of the consented OpenID claims to be accessed at the UserInfo endpoint.
MutableAccessTokenAuthorization	withClaimsData(net.minidev.json.JSONObject claimsData) Sets the claims fulfillment data for the claims source at the UserInfo endpoint.
MutableAccessTokenAuthorization	withClaimsLocales(List<com.nimbusds.langtag.LangTag> claimsLocales) Sets the preferred locales for the consented OpenID claims.
MutableAccessTokenAuthorization	withClientCertificateConfirmation(com.nimbusds.oauth2.sdk.auth.X509CertificateConfirmation cnfX5t) Sets the client X.509 certificate confirmation (SHA-256 thumbprint) for mutual TLS.
MutableAccessTokenAuthorization	withClientID(com.nimbusds.oauth2.sdk.id.ClientID clientID) Sets the identifier of the client to which the token is issued.
MutableAccessTokenAuthorization	withData(net.minidev.json.JSONObject data) Sets the optional data for the token.
MutableAccessTokenAuthorization	withExpirationTime(Instant exp) Sets the expiration time of the token.
MutableAccessTokenAuthorization	withIssuer(com.nimbusds.oauth2.sdk.id.Issuer iss) Sets the issuer of the token.
MutableAccessTokenAuthorization	withIssueTime(Instant iat) Sets the issue time of the token.
MutableAccessTokenAuthorization	withJWTID(com.nimbusds.oauth2.sdk.id.JWTID jti) Sets the JSON Web Token (JWT) identifier of the token.
MutableAccessTokenAuthorization	withOtherTopLevelParameters(Map<String,Object> params) Sets the other top-level parameters.
MutableAccessTokenAuthorization	withPresetClaims(net.minidev.json.JSONObject presetClaims) Sets the preset OpenID claims to be included in the UserInfo response.
MutableAccessTokenAuthorization	withScope(com.nimbusds.oauth2.sdk.Scope scope) Sets the scope of the token.
MutableAccessTokenAuthorization	withSubject(com.nimbusds.oauth2.sdk.id.Subject sub) Sets the token subject.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MutableAccessTokenAuthorization

public MutableAccessTokenAuthorization()

Creates a new empty mutable access token authorisation.

MutableAccessTokenAuthorization

public MutableAccessTokenAuthorization(AccessTokenAuthorization source)

Creates a new mutable access token authorisation from the specified one.

Parameters:

source - The source access token authorisation. Must not be null.

Method Detail

withSubject

public MutableAccessTokenAuthorization withSubject(com.nimbusds.oauth2.sdk.id.Subject sub)

Sets the token subject.

Parameters:

sub - The subject, null if not specified.

Returns:

This object.

getSubject

public com.nimbusds.oauth2.sdk.id.Subject getSubject()

Description copied from interface: AccessTokenAuthorization

Returns the token subject.

Specified by:

getSubject in interface AccessTokenAuthorization

Returns:

The subject, null if not specified.

withActor

public MutableAccessTokenAuthorization withActor(com.nimbusds.oauth2.sdk.id.Actor act)

Sets the token actor, in impersonation and delegation scenarios.

Parameters:

act - The actor, null if not specified.

Returns:

This object.

getActor

public com.nimbusds.oauth2.sdk.id.Actor getActor()

Description copied from interface: AccessTokenAuthorization

Returns the token actor, in impersonation and delegation scenarios.

Specified by:

getActor in interface AccessTokenAuthorization

Returns:

The actor, null if not specified.

withClientID

public MutableAccessTokenAuthorization withClientID(com.nimbusds.oauth2.sdk.id.ClientID clientID)

Sets the identifier of the client to which the token is issued.

Parameters:

clientID - The client identifier, null if not specified.

Returns:

This object.

getClientID

public com.nimbusds.oauth2.sdk.id.ClientID getClientID()

Description copied from interface: AccessTokenAuthorization

Returns the identifier of the client to which the token is issued.

Specified by:

getClientID in interface AccessTokenAuthorization

Returns:

The client identifier, null if not specified.

withScope

public MutableAccessTokenAuthorization withScope(com.nimbusds.oauth2.sdk.Scope scope)

Sets the scope of the token.

Parameters:

scope - The scope, null if not specified.

Returns:

This object.

getScope

public com.nimbusds.oauth2.sdk.Scope getScope()

Description copied from interface: AccessTokenAuthorization

Returns the scope of the token.

Specified by:

getScope in interface AccessTokenAuthorization

Returns:

The scope, null if not specified.

withExpirationTime

public MutableAccessTokenAuthorization withExpirationTime(Instant exp)

Sets the expiration time of the token.

Parameters:

exp - The expiration time, null if not specified.

Returns:

This object.

getExpirationTime

public Instant getExpirationTime()

Description copied from interface: AccessTokenAuthorization

Returns the expiration time of the token.

Specified by:

getExpirationTime in interface AccessTokenAuthorization

Returns:

The expiration time, null if not specified.

withIssueTime

public MutableAccessTokenAuthorization withIssueTime(Instant iat)

Sets the issue time of the token.

Parameters:

iat - The issue time, null if not specified.

Returns:

This object.

getIssueTime

public Instant getIssueTime()

Description copied from interface: AccessTokenAuthorization

Returns the issue time of the token.

Specified by:

getIssueTime in interface AccessTokenAuthorization

Returns:

The issue time, null if not specified.

withIssuer

public MutableAccessTokenAuthorization withIssuer(com.nimbusds.oauth2.sdk.id.Issuer iss)

Sets the issuer of the token.

Parameters:

iss - The issuer, null if not specified.

Returns:

This object.

getIssuer

public com.nimbusds.oauth2.sdk.id.Issuer getIssuer()

Description copied from interface: AccessTokenAuthorization

Returns the issuer of the token.

Specified by:

getIssuer in interface AccessTokenAuthorization

Returns:

The issuer, null if not specified.

withAudienceList

public MutableAccessTokenAuthorization withAudienceList(List<com.nimbusds.oauth2.sdk.id.Audience> audList)

Sets the audience list of the token, which may be the logical names of the intended resource servers.

Parameters:

audList - The audience list, null if not specified.

Returns:

This object.

getAudienceList

public List<com.nimbusds.oauth2.sdk.id.Audience> getAudienceList()

Description copied from interface: AccessTokenAuthorization

Returns the audience list of the token, which may be the logical names of the intended resource servers.

Specified by:

getAudienceList in interface AccessTokenAuthorization

Returns:

The audience list, null if not specified.

withJWTID

public MutableAccessTokenAuthorization withJWTID(com.nimbusds.oauth2.sdk.id.JWTID jti)

Sets the JSON Web Token (JWT) identifier of the token.

Parameters:

jti - The JWT ID, null if not specified or applicable.

Returns:

This object.

getJWTID

public com.nimbusds.oauth2.sdk.id.JWTID getJWTID()

Description copied from interface: AccessTokenAuthorization

Returns the JSON Web Token (JWT) identifier of the token.

Specified by:

getJWTID in interface AccessTokenAuthorization

Returns:

The JWT ID, null if not specified or applicable.

withClaimNames

public MutableAccessTokenAuthorization withClaimNames(Set<String> claimNames)

Sets the names of the consented OpenID claims to be accessed at the UserInfo endpoint.

Parameters:

claimNames - The claim names, null if not specified.

Returns:

This object.

getClaimNames

public Set<String> getClaimNames()

Description copied from interface: AccessTokenAuthorization

Returns the names of the consented OpenID claims to be accessed at the UserInfo endpoint.

Specified by:

getClaimNames in interface AccessTokenAuthorization

Returns:

The claim names, null if not specified.

withClaimsLocales

public MutableAccessTokenAuthorization withClaimsLocales(List<com.nimbusds.langtag.LangTag> claimsLocales)

Sets the preferred locales for the consented OpenID claims.

Parameters:

claimsLocales - The preferred claims locales, null if not specified.

Returns:

This object.

getClaimsLocales

public List<com.nimbusds.langtag.LangTag> getClaimsLocales()

Description copied from interface: AccessTokenAuthorization

Returns the preferred locales for the consented OpenID claims.

Specified by:

getClaimsLocales in interface AccessTokenAuthorization

Returns:

The preferred claims locales, null if not specified.

withPresetClaims

public MutableAccessTokenAuthorization withPresetClaims(net.minidev.json.JSONObject presetClaims)

Sets the preset OpenID claims to be included in the UserInfo response.

Parameters:

presetClaims - The preset OpenID claims, null if not specified.

Returns:

This object.

getPresetClaims

public net.minidev.json.JSONObject getPresetClaims()

Description copied from interface: AccessTokenAuthorization

Returns the preset OpenID claims to be included in the UserInfo response.

Specified by:

getPresetClaims in interface AccessTokenAuthorization

Returns:

The preset OpenID claims, null if not specified.

withClaimsData

public MutableAccessTokenAuthorization withClaimsData(net.minidev.json.JSONObject claimsData)

Sets the claims fulfillment data for the claims source at the UserInfo endpoint.

Parameters:

claimsData - The claims fulfillment data, null if not specified.

Returns:

This object.

getClaimsData

public net.minidev.json.JSONObject getClaimsData()

Description copied from interface: AccessTokenAuthorization

Returns the optional claims fulfillment data.

Specified by:

getClaimsData in interface AccessTokenAuthorization

Returns:

The claims fulfillment data, null if not specified.

withData

public MutableAccessTokenAuthorization withData(net.minidev.json.JSONObject data)

Sets the optional data for the token.

Parameters:

data - The optional data, represented as a JSON object, null if not specified.

Returns:

This object.

getData

public net.minidev.json.JSONObject getData()

Description copied from interface: AccessTokenAuthorization

Returns the optional data for the token.

Specified by:

getData in interface AccessTokenAuthorization

Returns:

The optional data, represented as a JSON object, null if not specified.

withClientCertificateConfirmation

public MutableAccessTokenAuthorization withClientCertificateConfirmation(com.nimbusds.oauth2.sdk.auth.X509CertificateConfirmation cnfX5t)

Sets the client X.509 certificate confirmation (SHA-256 thumbprint) for mutual TLS.

Parameters:

cnfX5t - The client X.509 certificate confirmation, null if not specified.

Returns:

This object.

getClientCertificateConfirmation

public com.nimbusds.oauth2.sdk.auth.X509CertificateConfirmation getClientCertificateConfirmation()

Description copied from interface: AccessTokenAuthorization

Returns the client X.509 certificate confirmation (SHA-256 thumbprint) for mutual TLS.

Specified by:

getClientCertificateConfirmation in interface AccessTokenAuthorization

Returns:

The client X.509 certificate confirmation, null if not specified.

withOtherTopLevelParameters

public MutableAccessTokenAuthorization withOtherTopLevelParameters(Map<String,Object> params)

Sets the other top-level parameters.

Parameters:

params - Other top-level parameters, the values should map to JSON entities, null if none.

Returns:

This object.

getOtherTopLevelParameters

public Map<String,Object> getOtherTopLevelParameters()

Description copied from interface: AccessTokenAuthorization

Returns a map of other top-level parameters.

Specified by:

getOtherTopLevelParameters in interface AccessTokenAuthorization

Returns:

Other top-level parameters, the values should map to JSON entities, null if none.

toString

public String toString()

Overrides:

toString in class Object