Package software.amazon.awscdk.services.cognito

Class UserPool

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.cognito.UserPool

All Implemented Interfaces:

IResource, IUserPool, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-29T11:15:35.407Z")
@Stability(Stable)
public class UserPool
extends Resource
implements IUserPool

Define a Cognito User Pool.

Example:

 UserPool pool = new UserPool(this, "Pool");
 pool.addClient("app-client", UserPoolClientOptions.builder()
         .oAuth(OAuthSettings.builder()
                 .flows(OAuthFlows.builder()
                         .authorizationCodeGrant(true)
                         .build())
                 .scopes(List.of(OAuthScope.OPENID))
                 .callbackUrls(List.of("https://my-app-domain.com/welcome"))
                 .logoutUrls(List.of("https://my-app-domain.com/signin"))
                 .build())
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	UserPool.Builder	A fluent builder for UserPool.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.cognito.IUserPool

IUserPool.Jsii$Default, IUserPool.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	UserPool(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	UserPool(software.amazon.jsii.JsiiObjectRef objRef)
	UserPool(software.constructs.Construct scope, String id)
	UserPool(software.constructs.Construct scope, String id, UserPoolProps props)

Method Summary

Modifier and Type	Method	Description
UserPoolClient	addClient(String id)	Add a new app client to this user pool.
UserPoolClient	addClient(String id, UserPoolClientOptions options)	Add a new app client to this user pool.
UserPoolDomain	addDomain(String id, UserPoolDomainOptions options)	Associate a domain to this user pool.
UserPoolGroup	addGroup(String id, UserPoolGroupOptions options)	Add a new group to this user pool.
UserPoolResourceServer	addResourceServer(String id, UserPoolResourceServerOptions options)	Add a new resource server to this user pool.
void	addTrigger(UserPoolOperation operation, IFunction fn)	Add a lambda trigger to a user pool operation.
void	addTrigger(UserPoolOperation operation, IFunction fn, LambdaVersion lambdaVersion)	Add a lambda trigger to a user pool operation.
static IUserPool	fromUserPoolArn(software.constructs.Construct scope, String id, String userPoolArn)	Import an existing user pool based on its ARN.
static IUserPool	fromUserPoolId(software.constructs.Construct scope, String id, String userPoolId)	Import an existing user pool based on its id.
List<IUserPoolIdentityProvider>	getIdentityProviders()	Get all identity providers registered with this user pool.
String	getUserPoolArn()	The ARN of the user pool.
String	getUserPoolId()	The physical ID of this user pool resource.
String	getUserPoolProviderName()	User pool provider name.
String	getUserPoolProviderUrl()	User pool provider URL.
Grant	grant(IGrantable grantee, String... actions)	Adds an IAM policy statement associated with this user pool to an IAM principal's policy.
void	registerIdentityProvider(IUserPoolIdentityProvider provider)	Register an identity provider with this user pool.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

UserPool

protected UserPool(software.amazon.jsii.JsiiObjectRef objRef)

UserPool

protected UserPool(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

UserPool

@Stability(Stable)
public UserPool(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 UserPoolProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

UserPool

@Stability(Stable)
public UserPool(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Details

fromUserPoolArn

@Stability(Stable)
@NotNull
public static IUserPool fromUserPoolArn(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String userPoolArn)

Import an existing user pool based on its ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

userPoolArn - This parameter is required.

fromUserPoolId

@Stability(Stable)
@NotNull
public static IUserPool fromUserPoolId(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String userPoolId)

Import an existing user pool based on its id.

Parameters:

scope - This parameter is required.

id - This parameter is required.

userPoolId - This parameter is required.

addClient

@Stability(Stable)
@NotNull
public UserPoolClient addClient(@NotNull
 String id,
 @Nullable
 UserPoolClientOptions options)

Add a new app client to this user pool.

Specified by:

addClient in interface IUserPool

Parameters:

id - This parameter is required.

options -

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html

addClient

@Stability(Stable)
@NotNull
public UserPoolClient addClient(@NotNull
 String id)

Add a new app client to this user pool.

Specified by:

addClient in interface IUserPool

Parameters:

id - This parameter is required.

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html

addDomain

@Stability(Stable)
@NotNull
public UserPoolDomain addDomain(@NotNull
 String id,
 @NotNull
 UserPoolDomainOptions options)

Associate a domain to this user pool.

Specified by:

addDomain in interface IUserPool

Parameters:

id - This parameter is required.

options - This parameter is required.

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html

addGroup

@Stability(Stable)
@NotNull
public UserPoolGroup addGroup(@NotNull
 String id,
 @NotNull
 UserPoolGroupOptions options)

Add a new group to this user pool.

Specified by:

addGroup in interface IUserPool

Parameters:

id - This parameter is required.

options - This parameter is required.

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-user-groups.html

addResourceServer

@Stability(Stable)
@NotNull
public UserPoolResourceServer addResourceServer(@NotNull
 String id,
 @NotNull
 UserPoolResourceServerOptions options)

Add a new resource server to this user pool.

Specified by:

addResourceServer in interface IUserPool

Parameters:

id - This parameter is required.

options - This parameter is required.

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-resource-servers.html

addTrigger

@Stability(Stable)
public void addTrigger(@NotNull
 UserPoolOperation operation,
 @NotNull
 IFunction fn,
 @Nullable
 LambdaVersion lambdaVersion)

Add a lambda trigger to a user pool operation.

Parameters:

operation - This parameter is required.

fn - This parameter is required.

lambdaVersion -

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html

addTrigger

@Stability(Stable)
public void addTrigger(@NotNull
 UserPoolOperation operation,
 @NotNull
 IFunction fn)

Add a lambda trigger to a user pool operation.

Parameters:

operation - This parameter is required.

fn - This parameter is required.

See Also:

• https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html

grant

@Stability(Stable)
@NotNull
public Grant grant(@NotNull
 IGrantable grantee,
 @NotNull
 String... actions)

Adds an IAM policy statement associated with this user pool to an IAM principal's policy.

Specified by:

grant in interface IUserPool

Parameters:

grantee - This parameter is required.

actions - This parameter is required.

registerIdentityProvider

@Stability(Stable)
public void registerIdentityProvider(@NotNull
 IUserPoolIdentityProvider provider)

Register an identity provider with this user pool.

Specified by:

registerIdentityProvider in interface IUserPool

Parameters:

provider - This parameter is required.

getIdentityProviders

@Stability(Stable)
@NotNull
public List<IUserPoolIdentityProvider> getIdentityProviders()

Get all identity providers registered with this user pool.

Specified by:

getIdentityProviders in interface IUserPool

getUserPoolArn

@Stability(Stable)
@NotNull
public String getUserPoolArn()

The ARN of the user pool.

Specified by:

getUserPoolArn in interface IUserPool

getUserPoolId

@Stability(Stable)
@NotNull
public String getUserPoolId()

The physical ID of this user pool resource.

Specified by:

getUserPoolId in interface IUserPool

getUserPoolProviderName

@Stability(Stable)
@NotNull
public String getUserPoolProviderName()

User pool provider name.

Specified by:

getUserPoolProviderName in interface IUserPool

getUserPoolProviderUrl

@Stability(Stable)
@NotNull
public String getUserPoolProviderUrl()

User pool provider URL.