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
Nested ClassesModifier and TypeClassDescriptionstatic interfaceThe available verified method a user can use to recover their password when they callForgotPassword.static interfaceThe settings for administrator creation of users in a user pool.static interfaceExample:static final classA fluent builder forCfnUserPool.static interfaceThe configuration of a custom email sender Lambda trigger.static interfaceThe configuration of a custom SMS sender Lambda trigger.static interfaceThe device-remembering configuration for a user pool.static interfaceThe email configuration of your user pool.static interfaceThe template for the welcome message to new users.static interfaceA collection of user pool Lambda triggers.static interfaceThe minimum and maximum values of an attribute that is of the number type, for examplecustom:age.static interfaceThe password policy settings for a user pool, including complexity, history, and length requirements.static interfaceA list of user pool policies.static interfaceThe properties of a pre token generation Lambda trigger.static interfaceA recovery option for a user.static interfaceA list of the user attributes and their properties in your user pool.static interfaceUser pool configuration for delivery of SMS messages with Amazon Simple Notification Service.static interfaceThe minimum and maximum length values of an attribute that is of the string type, for examplecustom:department.static interfaceThe settings for updates to user attributes.static interfaceCase sensitivity of the username input for the selected sign-in option.static interfaceUser pool add-ons.static interfaceThe 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.InitializationModeNested classes/interfaces inherited from interface software.constructs.IConstruct
software.constructs.IConstruct.Jsii$DefaultNested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable
IInspectable.Jsii$Default, IInspectable.Jsii$ProxyNested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable
ITaggable.Jsii$Default, ITaggable.Jsii$Proxy -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe CloudFormation resource type name for this resource class. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedCfnUserPool(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) protectedCfnUserPool(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,DeletionProtectionprevents 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.voidinspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.renderProperties(Map<String, Object> props) voidThe available verified method a user can use to recover their password when they callForgotPassword.voidThe available verified method a user can use to recover their password when they callForgotPassword.voidThe settings for administrator creation of users in a user pool.voidThe settings for administrator creation of users in a user pool.voidsetAliasAttributes(List<String> value) Attributes supported as an alias for this user pool.voidsetAutoVerifiedAttributes(List<String> value) The attributes to be auto-verified.voidsetDeletionProtection(String value) When active,DeletionProtectionprevents accidental deletion of your user pool.voidThe device-remembering configuration for a user pool.voidThe device-remembering configuration for a user pool.voidvoidvoidsetEmailConfiguration(IResolvable value) The email configuration of your user pool.voidThe email configuration of your user pool.voidThis parameter is no longer used.voidThis parameter is no longer used.voidsetEnabledMfas(List<String> value) Set enabled MFA options on a specified user pool.voidsetLambdaConfig(IResolvable value) A collection of user pool Lambda triggers.voidA collection of user pool Lambda triggers.voidsetMfaConfiguration(String value) The multi-factor authentication (MFA) configuration.voidsetPolicies(IResolvable value) A list of user pool policies.voidA list of user pool policies.voidAn array of schema attributes for the new user pool.voidsetSchema(IResolvable value) An array of schema attributes for the new user pool.voidThe contents of the SMS authentication message.voidsetSmsConfiguration(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.voidThe 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.voidsetSmsVerificationMessage(String value) This parameter is no longer used.voidThe settings for updates to user attributes.voidThe settings for updates to user attributes.voidsetUsernameAttributes(List<String> value) Specifies whether a user can use an email address or phone number as a username when they sign up.voidCase sensitivity on the username input for the selected sign-in option.voidCase sensitivity on the username input for the selected sign-in option.voidsetUserPoolAddOns(IResolvable value) User pool add-ons.voidUser pool add-ons.voidsetUserPoolName(String value) A string used to name the user pool.voidsetUserPoolTagsRaw(Object value) The tag keys and values to assign to the user pool.voidThe template for the verification message that your user pool delivers to users who set an email address or phone number attribute.voidThe 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, validatePropertiesMethods inherited from class software.amazon.awscdk.CfnRefElement
getRefMethods inherited from class software.amazon.awscdk.CfnElement
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalIdMethods inherited from class software.constructs.Construct
getNode, isConstructMethods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSetMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods 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:
inspectin 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:
renderPropertiesin 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:
getCfnPropertiesin 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,DeletionProtectionprevents accidental deletion of your user pool. -
setDeletionProtection
When active,DeletionProtectionprevents 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.
-