software.amazon.awscdk.services.cognito

Class UserPool

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.cognito.UserPool

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.71.0 (build f1f58ae)",
           date="2022-12-07T17:24:44.621Z")
 @Stability(value=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 and Description
static 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.amazon.awscdk.services.cognito.IUserPool

IUserPool.Jsii$Default, IUserPool.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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.
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.
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.core.Resource

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

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

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.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

UserPool

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

UserPool

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

UserPool

@Stability(value=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(value=Stable)
public UserPool(@NotNull
                                         software.constructs.Construct scope,
                                         @NotNull
                                         String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

fromUserPoolArn

@Stability(value=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(value=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(value=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(value=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(value=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

addResourceServer

@Stability(value=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(value=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(value=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.

Parameters:

grantee - This parameter is required.

actions - This parameter is required.

registerIdentityProvider

@Stability(value=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(value=Stable)
 @NotNull
public List<IUserPoolIdentityProvider> getIdentityProviders()

Get all identity providers registered with this user pool.

Specified by:

getIdentityProviders in interface IUserPool

getUserPoolArn

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

The ARN of the user pool.

Specified by:

getUserPoolArn in interface IUserPool

getUserPoolId

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

The physical ID of this user pool resource.

Specified by:

getUserPoolId in interface IUserPool

getUserPoolProviderName

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

User pool provider name.

getUserPoolProviderUrl

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

User pool provider URL.