Class CfnUserPool
java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.cognito.CfnUserPool
- All Implemented Interfaces:
IInspectable
,ITaggable
,software.amazon.jsii.JsiiSerializable
,software.constructs.IConstruct
,software.constructs.IDependable
@Generated(value="jsii-pacmak/1.104.0 (build e79254c)",
date="2024-11-06T23:25:06.311Z")
@Stability(Stable)
public class CfnUserPool
extends CfnResource
implements IInspectable, ITaggable
The
AWS::Cognito::UserPool
resource creates an Amazon Cognito user pool.
For more information on working with Amazon Cognito user pools, see Amazon Cognito User Pools and CreateUserPool .
If you don't specify a value for a parameter, Amazon Cognito sets it to a default value.
Example:
// The code below shows an example of how to instantiate this type. // The values are placeholders you should change. import software.amazon.awscdk.services.cognito.*; Object userPoolTags; CfnUserPool cfnUserPool = CfnUserPool.Builder.create(this, "MyCfnUserPool") .accountRecoverySetting(AccountRecoverySettingProperty.builder() .recoveryMechanisms(List.of(RecoveryOptionProperty.builder() .name("name") .priority(123) .build())) .build()) .adminCreateUserConfig(AdminCreateUserConfigProperty.builder() .allowAdminCreateUserOnly(false) .inviteMessageTemplate(InviteMessageTemplateProperty.builder() .emailMessage("emailMessage") .emailSubject("emailSubject") .smsMessage("smsMessage") .build()) .unusedAccountValidityDays(123) .build()) .aliasAttributes(List.of("aliasAttributes")) .autoVerifiedAttributes(List.of("autoVerifiedAttributes")) .deletionProtection("deletionProtection") .deviceConfiguration(DeviceConfigurationProperty.builder() .challengeRequiredOnNewDevice(false) .deviceOnlyRememberedOnUserPrompt(false) .build()) .emailAuthenticationMessage("emailAuthenticationMessage") .emailAuthenticationSubject("emailAuthenticationSubject") .emailConfiguration(EmailConfigurationProperty.builder() .configurationSet("configurationSet") .emailSendingAccount("emailSendingAccount") .from("from") .replyToEmailAddress("replyToEmailAddress") .sourceArn("sourceArn") .build()) .emailVerificationMessage("emailVerificationMessage") .emailVerificationSubject("emailVerificationSubject") .enabledMfas(List.of("enabledMfas")) .lambdaConfig(LambdaConfigProperty.builder() .createAuthChallenge("createAuthChallenge") .customEmailSender(CustomEmailSenderProperty.builder() .lambdaArn("lambdaArn") .lambdaVersion("lambdaVersion") .build()) .customMessage("customMessage") .customSmsSender(CustomSMSSenderProperty.builder() .lambdaArn("lambdaArn") .lambdaVersion("lambdaVersion") .build()) .defineAuthChallenge("defineAuthChallenge") .kmsKeyId("kmsKeyId") .postAuthentication("postAuthentication") .postConfirmation("postConfirmation") .preAuthentication("preAuthentication") .preSignUp("preSignUp") .preTokenGeneration("preTokenGeneration") .preTokenGenerationConfig(PreTokenGenerationConfigProperty.builder() .lambdaArn("lambdaArn") .lambdaVersion("lambdaVersion") .build()) .userMigration("userMigration") .verifyAuthChallengeResponse("verifyAuthChallengeResponse") .build()) .mfaConfiguration("mfaConfiguration") .policies(PoliciesProperty.builder() .passwordPolicy(PasswordPolicyProperty.builder() .minimumLength(123) .passwordHistorySize(123) .requireLowercase(false) .requireNumbers(false) .requireSymbols(false) .requireUppercase(false) .temporaryPasswordValidityDays(123) .build()) .build()) .schema(List.of(SchemaAttributeProperty.builder() .attributeDataType("attributeDataType") .developerOnlyAttribute(false) .mutable(false) .name("name") .numberAttributeConstraints(NumberAttributeConstraintsProperty.builder() .maxValue("maxValue") .minValue("minValue") .build()) .required(false) .stringAttributeConstraints(StringAttributeConstraintsProperty.builder() .maxLength("maxLength") .minLength("minLength") .build()) .build())) .smsAuthenticationMessage("smsAuthenticationMessage") .smsConfiguration(SmsConfigurationProperty.builder() .externalId("externalId") .snsCallerArn("snsCallerArn") .snsRegion("snsRegion") .build()) .smsVerificationMessage("smsVerificationMessage") .userAttributeUpdateSettings(UserAttributeUpdateSettingsProperty.builder() .attributesRequireVerificationBeforeUpdate(List.of("attributesRequireVerificationBeforeUpdate")) .build()) .usernameAttributes(List.of("usernameAttributes")) .usernameConfiguration(UsernameConfigurationProperty.builder() .caseSensitive(false) .build()) .userPoolAddOns(UserPoolAddOnsProperty.builder() .advancedSecurityAdditionalFlows(AdvancedSecurityAdditionalFlowsProperty.builder() .customAuthMode("customAuthMode") .build()) .advancedSecurityMode("advancedSecurityMode") .build()) .userPoolName("userPoolName") .userPoolTags(userPoolTags) .verificationMessageTemplate(VerificationMessageTemplateProperty.builder() .defaultEmailOption("defaultEmailOption") .emailMessage("emailMessage") .emailMessageByLink("emailMessageByLink") .emailSubject("emailSubject") .emailSubjectByLink("emailSubjectByLink") .smsMessage("smsMessage") .build()) .build();
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic interface
The available verified method a user can use to recover their password when they callForgotPassword
.static interface
The settings for administrator creation of users in a user pool.static interface
Example:static final class
A fluent builder forCfnUserPool
.static interface
The configuration of a custom email sender Lambda trigger.static interface
The configuration of a custom SMS sender Lambda trigger.static interface
The device-remembering configuration for a user pool.static interface
The email configuration of your user pool.static interface
The template for the welcome message to new users.static interface
A collection of user pool Lambda triggers.static interface
The minimum and maximum values of an attribute that is of the number type, for examplecustom:age
.static interface
The password policy settings for a user pool, including complexity, history, and length requirements.static interface
A list of user pool policies.static interface
The properties of a pre token generation Lambda trigger.static interface
A recovery option for a user.static interface
A list of the user attributes and their properties in your user pool.static interface
User pool configuration for delivery of SMS messages with Amazon Simple Notification Service.static interface
The minimum and maximum length values of an attribute that is of the string type, for examplecustom:department
.static interface
The settings for updates to user attributes.static interface
Case sensitivity of the username input for the selected sign-in option.static interface
User pool add-ons.static interface
The template for the verification message that your user pool delivers to users who set an email address or phone number attribute.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.IInspectable
IInspectable.Jsii$Default, IInspectable.Jsii$Proxy
Nested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable
ITaggable.Jsii$Default, ITaggable.Jsii$Proxy
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
The CloudFormation resource type name for this resource class. -
Constructor Summary
ModifierConstructorDescriptionprotected
CfnUserPool
(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) protected
CfnUserPool
(software.amazon.jsii.JsiiObjectRef objRef) CfnUserPool
(software.constructs.Construct scope, String id) CfnUserPool
(software.constructs.Construct scope, String id, CfnUserPoolProps props) -
Method Summary
Modifier and TypeMethodDescriptionThe available verified method a user can use to recover their password when they callForgotPassword
.The settings for administrator creation of users in a user pool.Attributes supported as an alias for this user pool.The Amazon Resource Name (ARN) of the user pool, such asarn:aws:cognito-idp:us-east-1:123412341234:userpool/us-east-1_123412341
.A friendly name for the IdP.The URL of the provider of the Amazon Cognito user pool, specified as aString
.The ID of the user pool.The attributes to be auto-verified.When active,DeletionProtection
prevents accidental deletion of your user pool.The device-remembering configuration for a user pool.The email configuration of your user pool.This parameter is no longer used.This parameter is no longer used.Set enabled MFA options on a specified user pool.A collection of user pool Lambda triggers.The multi-factor authentication (MFA) configuration.A list of user pool policies.An array of schema attributes for the new user pool.The contents of the SMS authentication message.The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service.This parameter is no longer used.getTags()
Tag Manager which manages the tags for this resource.The settings for updates to user attributes.Specifies whether a user can use an email address or phone number as a username when they sign up.Case sensitivity on the username input for the selected sign-in option.User pool add-ons.A string used to name the user pool.The tag keys and values to assign to the user pool.The template for the verification message that your user pool delivers to users who set an email address or phone number attribute.void
inspect
(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.renderProperties
(Map<String, Object> props) void
The available verified method a user can use to recover their password when they callForgotPassword
.void
The available verified method a user can use to recover their password when they callForgotPassword
.void
The settings for administrator creation of users in a user pool.void
The settings for administrator creation of users in a user pool.void
setAliasAttributes
(List<String> value) Attributes supported as an alias for this user pool.void
setAutoVerifiedAttributes
(List<String> value) The attributes to be auto-verified.void
setDeletionProtection
(String value) When active,DeletionProtection
prevents accidental deletion of your user pool.void
The device-remembering configuration for a user pool.void
The device-remembering configuration for a user pool.void
void
void
setEmailConfiguration
(IResolvable value) The email configuration of your user pool.void
The email configuration of your user pool.void
This parameter is no longer used.void
This parameter is no longer used.void
setEnabledMfas
(List<String> value) Set enabled MFA options on a specified user pool.void
setLambdaConfig
(IResolvable value) A collection of user pool Lambda triggers.void
A collection of user pool Lambda triggers.void
setMfaConfiguration
(String value) The multi-factor authentication (MFA) configuration.void
setPolicies
(IResolvable value) A list of user pool policies.void
A list of user pool policies.void
An array of schema attributes for the new user pool.void
setSchema
(IResolvable value) An array of schema attributes for the new user pool.void
The contents of the SMS authentication message.void
setSmsConfiguration
(IResolvable value) The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service.void
The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service.void
setSmsVerificationMessage
(String value) This parameter is no longer used.void
The settings for updates to user attributes.void
The settings for updates to user attributes.void
setUsernameAttributes
(List<String> value) Specifies whether a user can use an email address or phone number as a username when they sign up.void
Case sensitivity on the username input for the selected sign-in option.void
Case sensitivity on the username input for the selected sign-in option.void
setUserPoolAddOns
(IResolvable value) User pool add-ons.void
User pool add-ons.void
setUserPoolName
(String value) A string used to name the user pool.void
setUserPoolTagsRaw
(Object value) The tag keys and values to assign to the user pool.void
The template for the verification message that your user pool delivers to users who set an email address or phone number attribute.void
The template for the verification message that your user pool delivers to users who set an email address or phone number attribute.Methods inherited from class software.amazon.awscdk.CfnResource
addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties
Methods inherited from class software.amazon.awscdk.CfnRefElement
getRef
Methods inherited from class software.amazon.awscdk.CfnElement
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId
Methods inherited from class software.constructs.Construct
getNode, isConstruct
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.jsii.JsiiSerializable
$jsii$toJson
-
Field Details
-
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
-
-
Constructor Details
-
CfnUserPool
protected CfnUserPool(software.amazon.jsii.JsiiObjectRef objRef) -
CfnUserPool
protected CfnUserPool(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) -
CfnUserPool
@Stability(Stable) public CfnUserPool(@NotNull software.constructs.Construct scope, @NotNull String id, @Nullable CfnUserPoolProps props) - Parameters:
scope
- Scope in which this resource is defined. This parameter is required.id
- Construct identifier for this resource (unique in its scope). This parameter is required.props
- Resource properties.
-
CfnUserPool
@Stability(Stable) public CfnUserPool(@NotNull software.constructs.Construct scope, @NotNull String id) - Parameters:
scope
- Scope in which this resource is defined. This parameter is required.id
- Construct identifier for this resource (unique in its scope). This parameter is required.
-
-
Method Details
-
inspect
Examines the CloudFormation resource and discloses attributes.- Specified by:
inspect
in interfaceIInspectable
- Parameters:
inspector
- tree inspector to collect and process attributes. This parameter is required.
-
renderProperties
@Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String, Object> props) - Overrides:
renderProperties
in classCfnResource
- Parameters:
props
- This parameter is required.
-
getAttrArn
The Amazon Resource Name (ARN) of the user pool, such asarn:aws:cognito-idp:us-east-1:123412341234:userpool/us-east-1_123412341
. -
getAttrProviderName
A friendly name for the IdP. -
getAttrProviderUrl
The URL of the provider of the Amazon Cognito user pool, specified as aString
. -
getAttrUserPoolId
The ID of the user pool. -
getCfnProperties
- Overrides:
getCfnProperties
in classCfnResource
-
getTags
Tag Manager which manages the tags for this resource. -
getAccountRecoverySetting
The available verified method a user can use to recover their password when they callForgotPassword
. -
setAccountRecoverySetting
The available verified method a user can use to recover their password when they callForgotPassword
. -
setAccountRecoverySetting
@Stability(Stable) public void setAccountRecoverySetting(@Nullable CfnUserPool.AccountRecoverySettingProperty value) The available verified method a user can use to recover their password when they callForgotPassword
. -
getAdminCreateUserConfig
The settings for administrator creation of users in a user pool. -
setAdminCreateUserConfig
The settings for administrator creation of users in a user pool. -
setAdminCreateUserConfig
@Stability(Stable) public void setAdminCreateUserConfig(@Nullable CfnUserPool.AdminCreateUserConfigProperty value) The settings for administrator creation of users in a user pool. -
getAliasAttributes
Attributes supported as an alias for this user pool. -
setAliasAttributes
Attributes supported as an alias for this user pool. -
getAutoVerifiedAttributes
The attributes to be auto-verified. -
setAutoVerifiedAttributes
The attributes to be auto-verified. -
getDeletionProtection
When active,DeletionProtection
prevents accidental deletion of your user pool. -
setDeletionProtection
When active,DeletionProtection
prevents accidental deletion of your user pool. -
getDeviceConfiguration
The device-remembering configuration for a user pool. -
setDeviceConfiguration
The device-remembering configuration for a user pool. -
setDeviceConfiguration
@Stability(Stable) public void setDeviceConfiguration(@Nullable CfnUserPool.DeviceConfigurationProperty value) The device-remembering configuration for a user pool. -
getEmailAuthenticationMessage
-
setEmailAuthenticationMessage
-
getEmailAuthenticationSubject
-
setEmailAuthenticationSubject
-
getEmailConfiguration
The email configuration of your user pool. -
setEmailConfiguration
The email configuration of your user pool. -
setEmailConfiguration
@Stability(Stable) public void setEmailConfiguration(@Nullable CfnUserPool.EmailConfigurationProperty value) The email configuration of your user pool. -
getEmailVerificationMessage
This parameter is no longer used. -
setEmailVerificationMessage
This parameter is no longer used. -
getEmailVerificationSubject
This parameter is no longer used. -
setEmailVerificationSubject
This parameter is no longer used. -
getEnabledMfas
Set enabled MFA options on a specified user pool. -
setEnabledMfas
Set enabled MFA options on a specified user pool. -
getLambdaConfig
A collection of user pool Lambda triggers. -
setLambdaConfig
A collection of user pool Lambda triggers. -
setLambdaConfig
A collection of user pool Lambda triggers. -
getMfaConfiguration
The multi-factor authentication (MFA) configuration.Valid values include:.
-
setMfaConfiguration
The multi-factor authentication (MFA) configuration.Valid values include:.
-
getPolicies
A list of user pool policies.Contains the policy that sets password-complexity requirements.
-
setPolicies
A list of user pool policies.Contains the policy that sets password-complexity requirements.
-
setPolicies
A list of user pool policies.Contains the policy that sets password-complexity requirements.
-
getSchema
An array of schema attributes for the new user pool. -
setSchema
An array of schema attributes for the new user pool. -
setSchema
An array of schema attributes for the new user pool. -
getSmsAuthenticationMessage
The contents of the SMS authentication message. -
setSmsAuthenticationMessage
The contents of the SMS authentication message. -
getSmsConfiguration
The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service. -
setSmsConfiguration
The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service. -
setSmsConfiguration
@Stability(Stable) public void setSmsConfiguration(@Nullable CfnUserPool.SmsConfigurationProperty value) The SMS configuration with the settings that your Amazon Cognito user pool must use to send an SMS message from your AWS account through Amazon Simple Notification Service. -
getSmsVerificationMessage
This parameter is no longer used. -
setSmsVerificationMessage
This parameter is no longer used. -
getUserAttributeUpdateSettings
The settings for updates to user attributes. -
setUserAttributeUpdateSettings
The settings for updates to user attributes. -
setUserAttributeUpdateSettings
@Stability(Stable) public void setUserAttributeUpdateSettings(@Nullable CfnUserPool.UserAttributeUpdateSettingsProperty value) The settings for updates to user attributes. -
getUsernameAttributes
Specifies whether a user can use an email address or phone number as a username when they sign up. -
setUsernameAttributes
Specifies whether a user can use an email address or phone number as a username when they sign up. -
getUsernameConfiguration
Case sensitivity on the username input for the selected sign-in option. -
setUsernameConfiguration
Case sensitivity on the username input for the selected sign-in option. -
setUsernameConfiguration
@Stability(Stable) public void setUsernameConfiguration(@Nullable CfnUserPool.UsernameConfigurationProperty value) Case sensitivity on the username input for the selected sign-in option. -
getUserPoolAddOns
User pool add-ons. -
setUserPoolAddOns
User pool add-ons. -
setUserPoolAddOns
@Stability(Stable) public void setUserPoolAddOns(@Nullable CfnUserPool.UserPoolAddOnsProperty value) User pool add-ons. -
getUserPoolName
A string used to name the user pool. -
setUserPoolName
A string used to name the user pool. -
getUserPoolTagsRaw
The tag keys and values to assign to the user pool. -
setUserPoolTagsRaw
The tag keys and values to assign to the user pool. -
getVerificationMessageTemplate
The template for the verification message that your user pool delivers to users who set an email address or phone number attribute. -
setVerificationMessageTemplate
The template for the verification message that your user pool delivers to users who set an email address or phone number attribute. -
setVerificationMessageTemplate
@Stability(Stable) public void setVerificationMessageTemplate(@Nullable CfnUserPool.VerificationMessageTemplateProperty value) The template for the verification message that your user pool delivers to users who set an email address or phone number attribute.
-