software.amazon.awscdk.services.cognito

Class UserPoolClient.Builder

java.lang.Object

software.amazon.awscdk.services.cognito.UserPoolClient.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<UserPoolClient>

Enclosing class:

UserPoolClient

@Stability(value=Experimental)
public static final class UserPoolClient.Builder
extends Object
implements software.amazon.jsii.Builder<UserPoolClient>

(experimental) A fluent builder for UserPoolClient.

Method Summary

Modifier and Type	Method and Description
UserPoolClient.Builder	authFlows(AuthFlow authFlows) (experimental) The set of OAuth authentication flows to enable on the client.
UserPoolClient	build()
static UserPoolClient.Builder	create(software.constructs.Construct scope, String id)
UserPoolClient.Builder	disableOAuth(Boolean disableOAuth) (experimental) Turns off all OAuth interactions for this client.
UserPoolClient.Builder	generateSecret(Boolean generateSecret) (experimental) Whether to generate a client secret.
UserPoolClient.Builder	oAuth(OAuthSettings oAuth) (experimental) OAuth settings for this to client to interact with the app.
UserPoolClient.Builder	preventUserExistenceErrors(Boolean preventUserExistenceErrors) (experimental) 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.
UserPoolClient.Builder	supportedIdentityProviders(List<? extends UserPoolClientIdentityProvider> supportedIdentityProviders) (experimental) The list of identity providers that users should be able to use to sign in using this client.
UserPoolClient.Builder	userPool(IUserPool userPool) (experimental) The UserPool resource this client will have access to.
UserPoolClient.Builder	userPoolClientName(String userPoolClientName) (experimental) Name of the application client.

Methods inherited from class java.lang.Object

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

Method Detail

create

@Stability(value=Experimental)
public static UserPoolClient.Builder create(software.constructs.Construct scope,
                                                                           String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of UserPoolClient.Builder.

authFlows

@Stability(value=Experimental)
public UserPoolClient.Builder authFlows(AuthFlow authFlows)

(experimental) The set of OAuth authentication flows to enable on the client.

Default: - all auth flows disabled

Parameters:

authFlows - The set of OAuth authentication flows to enable on the client. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow.html

disableOAuth

@Stability(value=Experimental)
public UserPoolClient.Builder disableOAuth(Boolean disableOAuth)

(experimental) Turns off all OAuth interactions for this client.

Default: false

Parameters:

disableOAuth - Turns off all OAuth interactions for this client. This parameter is required.

Returns:

this

generateSecret

@Stability(value=Experimental)
public UserPoolClient.Builder generateSecret(Boolean generateSecret)

(experimental) Whether to generate a client secret.

Default: false

Parameters:

generateSecret - Whether to generate a client secret. This parameter is required.

Returns:

this

oAuth

@Stability(value=Experimental)
public UserPoolClient.Builder oAuth(OAuthSettings oAuth)

(experimental) OAuth settings for this to client to interact with the app.

An error is thrown when this is specified and disableOAuth is set.

Default: - see defaults in `OAuthSettings`. meaningless if `disableOAuth` is set.

Parameters:

oAuth - OAuth settings for this to client to interact with the app. This parameter is required.

Returns:

this

preventUserExistenceErrors

@Stability(value=Experimental)
public UserPoolClient.Builder preventUserExistenceErrors(Boolean preventUserExistenceErrors)

(experimental) 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.

Default: true for new stacks

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. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-managing-errors.html

supportedIdentityProviders

@Stability(value=Experimental)
public UserPoolClient.Builder supportedIdentityProviders(List<? extends UserPoolClientIdentityProvider> supportedIdentityProviders)

(experimental) The list of identity providers that users should be able to use to sign in using this client.

Default: - supports all identity providers that are registered with the user pool. If the user pool and/or identity providers are imported, either specify this option explicitly or ensure that the identity providers are registered with the user pool using the `UserPool.registerIdentityProvider()` API.

Parameters:

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

Returns:

this

userPoolClientName

@Stability(value=Experimental)
public UserPoolClient.Builder userPoolClientName(String userPoolClientName)

(experimental) Name of the application client.

Default: - cloudformation generated name

Parameters:

userPoolClientName - Name of the application client. This parameter is required.

Returns:

this

userPool

@Stability(value=Experimental)
public UserPoolClient.Builder userPool(IUserPool userPool)

(experimental) The UserPool resource this client will have access to.

Parameters:

userPool - The UserPool resource this client will have access to. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public UserPoolClient build()

Specified by:

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