Package software.amazon.awscdk.services.cognito

Class UserPoolClientOptions.Builder

java.lang.Object

software.amazon.awscdk.services.cognito.UserPoolClientOptions.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<UserPoolClientOptions>

Enclosing interface:

UserPoolClientOptions

@Stability(Stable)
public static final class UserPoolClientOptions.Builder
extends Object
implements software.amazon.jsii.Builder<UserPoolClientOptions>

A builder for UserPoolClientOptions

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
UserPoolClientOptions.Builder	accessTokenValidity(Duration accessTokenValidity)	Sets the value of UserPoolClientOptions.getAccessTokenValidity()
UserPoolClientOptions.Builder	authFlows(AuthFlow authFlows)	Sets the value of UserPoolClientOptions.getAuthFlows()
UserPoolClientOptions.Builder	authSessionValidity(Duration authSessionValidity)	Sets the value of UserPoolClientOptions.getAuthSessionValidity()
UserPoolClientOptions	build()	Builds the configured instance.
UserPoolClientOptions.Builder	disableOAuth(Boolean disableOAuth)	Sets the value of UserPoolClientOptions.getDisableOAuth()
UserPoolClientOptions.Builder	enableTokenRevocation(Boolean enableTokenRevocation)	Sets the value of UserPoolClientOptions.getEnableTokenRevocation()
UserPoolClientOptions.Builder	generateSecret(Boolean generateSecret)	Sets the value of UserPoolClientOptions.getGenerateSecret()
UserPoolClientOptions.Builder	idTokenValidity(Duration idTokenValidity)	Sets the value of UserPoolClientOptions.getIdTokenValidity()
UserPoolClientOptions.Builder	oAuth(OAuthSettings oAuth)	Sets the value of UserPoolClientOptions.getOAuth()
UserPoolClientOptions.Builder	preventUserExistenceErrors(Boolean preventUserExistenceErrors)	Sets the value of UserPoolClientOptions.getPreventUserExistenceErrors()
UserPoolClientOptions.Builder	readAttributes(ClientAttributes readAttributes)	Sets the value of UserPoolClientOptions.getReadAttributes()
UserPoolClientOptions.Builder	refreshTokenValidity(Duration refreshTokenValidity)	Sets the value of UserPoolClientOptions.getRefreshTokenValidity()
UserPoolClientOptions.Builder	supportedIdentityProviders(List<? extends UserPoolClientIdentityProvider> supportedIdentityProviders)	Sets the value of UserPoolClientOptions.getSupportedIdentityProviders()
UserPoolClientOptions.Builder	userPoolClientName(String userPoolClientName)	Sets the value of UserPoolClientOptions.getUserPoolClientName()
UserPoolClientOptions.Builder	writeAttributes(ClientAttributes writeAttributes)	Sets the value of UserPoolClientOptions.getWriteAttributes()

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder()

Method Details

accessTokenValidity

@Stability(Stable)
public UserPoolClientOptions.Builder accessTokenValidity(Duration accessTokenValidity)

Sets the value of UserPoolClientOptions.getAccessTokenValidity()

Parameters:

accessTokenValidity - Validity of the access token. Values between 5 minutes and 1 day are valid. The duration can not be longer than the refresh token validity.

Returns:

this

authFlows

@Stability(Stable)
public UserPoolClientOptions.Builder authFlows(AuthFlow authFlows)

Sets the value of UserPoolClientOptions.getAuthFlows()

Parameters:

authFlows - The set of OAuth authentication flows to enable on the client.

Returns:

this

authSessionValidity

@Stability(Stable)
public UserPoolClientOptions.Builder authSessionValidity(Duration authSessionValidity)

Sets the value of UserPoolClientOptions.getAuthSessionValidity()

Parameters:

authSessionValidity - Cognito creates a session token for each API request in an authentication flow. AuthSessionValidity is the duration, in minutes, of that session token. see defaults in AuthSessionValidity. Valid duration is from 3 to 15 minutes.

Returns:

this

disableOAuth

@Stability(Stable)
public UserPoolClientOptions.Builder disableOAuth(Boolean disableOAuth)

Sets the value of UserPoolClientOptions.getDisableOAuth()

Parameters:

disableOAuth - Turns off all OAuth interactions for this client.

Returns:

this

enableTokenRevocation

@Stability(Stable)
public UserPoolClientOptions.Builder enableTokenRevocation(Boolean enableTokenRevocation)

Sets the value of UserPoolClientOptions.getEnableTokenRevocation()

Parameters:

enableTokenRevocation - Enable token revocation for this client.

Returns:

this

generateSecret

@Stability(Stable)
public UserPoolClientOptions.Builder generateSecret(Boolean generateSecret)

Sets the value of UserPoolClientOptions.getGenerateSecret()

Parameters:

generateSecret - Whether to generate a client secret.

Returns:

this

idTokenValidity

@Stability(Stable)
public UserPoolClientOptions.Builder idTokenValidity(Duration idTokenValidity)

Sets the value of UserPoolClientOptions.getIdTokenValidity()

Parameters:

idTokenValidity - Validity of the ID token. Values between 5 minutes and 1 day are valid. The duration can not be longer than the refresh token validity.

Returns:

this

oAuth

@Stability(Stable)
public UserPoolClientOptions.Builder oAuth(OAuthSettings oAuth)

Sets the value of UserPoolClientOptions.getOAuth()

Parameters:

oAuth - OAuth settings for this client to interact with the app. An error is thrown when this is specified and disableOAuth is set.

Returns:

this

preventUserExistenceErrors

@Stability(Stable)
public UserPoolClientOptions.Builder preventUserExistenceErrors(Boolean preventUserExistenceErrors)

Sets the value of UserPoolClientOptions.getPreventUserExistenceErrors()

Parameters:

preventUserExistenceErrors - Whether Cognito returns a UserNotFoundException exception when the user does not exist in the user pool (false), or whether it returns another type of error that doesn't reveal the user's absence.

Returns:

this

readAttributes

@Stability(Stable)
public UserPoolClientOptions.Builder readAttributes(ClientAttributes readAttributes)

Sets the value of UserPoolClientOptions.getReadAttributes()

Parameters:

readAttributes - The set of attributes this client will be able to read.

Returns:

this

refreshTokenValidity

@Stability(Stable)
public UserPoolClientOptions.Builder refreshTokenValidity(Duration refreshTokenValidity)

Sets the value of UserPoolClientOptions.getRefreshTokenValidity()

Parameters:

refreshTokenValidity - Validity of the refresh token. Values between 60 minutes and 10 years are valid.

Returns:

this

supportedIdentityProviders

@Stability(Stable)
public UserPoolClientOptions.Builder supportedIdentityProviders(List<? extends UserPoolClientIdentityProvider> supportedIdentityProviders)

Sets the value of UserPoolClientOptions.getSupportedIdentityProviders()

Parameters:

supportedIdentityProviders - The list of identity providers that users should be able to use to sign in using this client.

Returns:

this

userPoolClientName

@Stability(Stable)
public UserPoolClientOptions.Builder userPoolClientName(String userPoolClientName)

Sets the value of UserPoolClientOptions.getUserPoolClientName()

Parameters:

userPoolClientName - Name of the application client.

Returns:

this

writeAttributes

@Stability(Stable)
public UserPoolClientOptions.Builder writeAttributes(ClientAttributes writeAttributes)

Sets the value of UserPoolClientOptions.getWriteAttributes()

Parameters:

writeAttributes - The set of attributes this client will be able to write.

Returns:

this

build

@Stability(Stable)
public UserPoolClientOptions build()

Builds the configured instance.

Specified by:

build in interface software.amazon.jsii.Builder<UserPoolClientOptions>

Returns:

a new instance of UserPoolClientOptions

Throws:

NullPointerException - if any required attribute was not provided