@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)", date="2022-01-04T15:39:05.026Z") @Stability(value=Stable) public class CfnUserPoolClient extends CfnResource implements IInspectable
The AWS::Cognito::UserPoolClient resource specifies an Amazon Cognito user pool client.
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.*;
CfnUserPoolClient cfnUserPoolClient = CfnUserPoolClient.Builder.create(this, "MyCfnUserPoolClient")
.userPoolId("userPoolId")
// the properties below are optional
.accessTokenValidity(123)
.allowedOAuthFlows(List.of("allowedOAuthFlows"))
.allowedOAuthFlowsUserPoolClient(false)
.allowedOAuthScopes(List.of("allowedOAuthScopes"))
.analyticsConfiguration(AnalyticsConfigurationProperty.builder()
.applicationArn("applicationArn")
.applicationId("applicationId")
.externalId("externalId")
.roleArn("roleArn")
.userDataShared(false)
.build())
.callbackUrLs(List.of("callbackUrLs"))
.clientName("clientName")
.defaultRedirectUri("defaultRedirectUri")
.enableTokenRevocation(false)
.explicitAuthFlows(List.of("explicitAuthFlows"))
.generateSecret(false)
.idTokenValidity(123)
.logoutUrLs(List.of("logoutUrLs"))
.preventUserExistenceErrors("preventUserExistenceErrors")
.readAttributes(List.of("readAttributes"))
.refreshTokenValidity(123)
.supportedIdentityProviders(List.of("supportedIdentityProviders"))
.tokenValidityUnits(TokenValidityUnitsProperty.builder()
.accessToken("accessToken")
.idToken("idToken")
.refreshToken("refreshToken")
.build())
.writeAttributes(List.of("writeAttributes"))
.build();
| Modifier and Type | Class and Description |
|---|---|
static interface |
CfnUserPoolClient.AnalyticsConfigurationProperty
The Amazon Pinpoint analytics configuration for collecting metrics for a user pool.
|
static class |
CfnUserPoolClient.Builder
A fluent builder for
CfnUserPoolClient. |
static interface |
CfnUserPoolClient.TokenValidityUnitsProperty
The units in which the validity times are represented in.
|
software.amazon.jsii.JsiiObject.InitializationModeIInspectable.Jsii$Default, IInspectable.Jsii$ProxyIConstruct.Jsii$Default| Modifier and Type | Field and Description |
|---|---|
static String |
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
|
| Modifier | Constructor and Description |
|---|---|
|
CfnUserPoolClient(Construct scope,
String id,
CfnUserPoolClientProps props)
Create a new `AWS::Cognito::UserPoolClient`.
|
protected |
CfnUserPoolClient(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) |
protected |
CfnUserPoolClient(software.amazon.jsii.JsiiObjectRef objRef) |
| Modifier and Type | Method and Description |
|---|---|
Number |
getAccessTokenValidity()
The time limit, after which the access token is no longer valid and cannot be used.
|
List<String> |
getAllowedOAuthFlows()
The allowed OAuth flows.
|
Object |
getAllowedOAuthFlowsUserPoolClient()
Set to true if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.
|
List<String> |
getAllowedOAuthScopes()
The allowed OAuth scopes.
|
Object |
getAnalyticsConfiguration()
The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.
|
String |
getAttrClientSecret() |
String |
getAttrName() |
List<String> |
getCallbackUrLs()
A list of allowed redirect (callback) URLs for the identity providers.
|
protected Map<String,Object> |
getCfnProperties() |
String |
getClientName()
The client name for the user pool client you would like to create.
|
String |
getDefaultRedirectUri()
The default redirect URI.
|
Object |
getEnableTokenRevocation()
Enables or disables token revocation.
|
List<String> |
getExplicitAuthFlows()
The authentication flows that are supported by the user pool clients.
|
Object |
getGenerateSecret()
Boolean to specify whether you want to generate a secret for the user pool client being created.
|
Number |
getIdTokenValidity()
The time limit, after which the ID token is no longer valid and cannot be used.
|
List<String> |
getLogoutUrLs()
A list of allowed logout URLs for the identity providers.
|
String |
getPreventUserExistenceErrors()
Use this setting to choose which errors and responses are returned by Cognito APIs during authentication, account confirmation, and password recovery when the user does not exist in the user pool.
|
List<String> |
getReadAttributes()
The read attributes.
|
Number |
getRefreshTokenValidity()
The time limit, in days, after which the refresh token is no longer valid and cannot be used.
|
List<String> |
getSupportedIdentityProviders()
A list of provider names for the identity providers that are supported on this client.
|
Object |
getTokenValidityUnits()
The units in which the validity times are represented in.
|
String |
getUserPoolId()
The user pool ID for the user pool where you want to create a user pool client.
|
List<String> |
getWriteAttributes()
The user pool attributes that the app client can write to.
|
void |
inspect(TreeInspector inspector)
Examines the CloudFormation resource and discloses attributes.
|
protected Map<String,Object> |
renderProperties(Map<String,Object> props) |
void |
setAccessTokenValidity(Number value)
The time limit, after which the access token is no longer valid and cannot be used.
|
void |
setAllowedOAuthFlows(List<String> value)
The allowed OAuth flows.
|
void |
setAllowedOAuthFlowsUserPoolClient(Boolean value)
Set to true if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.
|
void |
setAllowedOAuthFlowsUserPoolClient(IResolvable value)
Set to true if the client is allowed to follow the OAuth protocol when interacting with Cognito user pools.
|
void |
setAllowedOAuthScopes(List<String> value)
The allowed OAuth scopes.
|
void |
setAnalyticsConfiguration(CfnUserPoolClient.AnalyticsConfigurationProperty value)
The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.
|
void |
setAnalyticsConfiguration(IResolvable value)
The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.
|
void |
setCallbackUrLs(List<String> value)
A list of allowed redirect (callback) URLs for the identity providers.
|
void |
setClientName(String value)
The client name for the user pool client you would like to create.
|
void |
setDefaultRedirectUri(String value)
The default redirect URI.
|
void |
setEnableTokenRevocation(Boolean value)
Enables or disables token revocation.
|
void |
setEnableTokenRevocation(IResolvable value)
Enables or disables token revocation.
|
void |
setExplicitAuthFlows(List<String> value)
The authentication flows that are supported by the user pool clients.
|
void |
setGenerateSecret(Boolean value)
Boolean to specify whether you want to generate a secret for the user pool client being created.
|
void |
setGenerateSecret(IResolvable value)
Boolean to specify whether you want to generate a secret for the user pool client being created.
|
void |
setIdTokenValidity(Number value)
The time limit, after which the ID token is no longer valid and cannot be used.
|
void |
setLogoutUrLs(List<String> value)
A list of allowed logout URLs for the identity providers.
|
void |
setPreventUserExistenceErrors(String value)
Use this setting to choose which errors and responses are returned by Cognito APIs during authentication, account confirmation, and password recovery when the user does not exist in the user pool.
|
void |
setReadAttributes(List<String> value)
The read attributes.
|
void |
setRefreshTokenValidity(Number value)
The time limit, in days, after which the refresh token is no longer valid and cannot be used.
|
void |
setSupportedIdentityProviders(List<String> value)
A list of provider names for the identity providers that are supported on this client.
|
void |
setTokenValidityUnits(CfnUserPoolClient.TokenValidityUnitsProperty value)
The units in which the validity times are represented in.
|
void |
setTokenValidityUnits(IResolvable value)
The units in which the validity times are represented in.
|
void |
setUserPoolId(String value)
The user pool ID for the user pool where you want to create a user pool client.
|
void |
setWriteAttributes(List<String> value)
The user pool attributes that the app client can write to.
|
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validatePropertiesgetRefgetCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalIdgetNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validatejsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet@Stability(value=Stable) public static final String CFN_RESOURCE_TYPE_NAME
protected CfnUserPoolClient(software.amazon.jsii.JsiiObjectRef objRef)
protected CfnUserPoolClient(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
@Stability(value=Stable)
public CfnUserPoolClient(@NotNull
Construct scope,
@NotNull
String id,
@NotNull
CfnUserPoolClientProps props)
scope - - scope in which this resource is defined. This parameter is required.id - - scoped id of the resource. This parameter is required.props - - resource properties. This parameter is required.@Stability(value=Stable)
public void inspect(@NotNull
TreeInspector inspector)
inspect in interface IInspectableinspector - - tree inspector to collect and process attributes. This parameter is required.@Stability(value=Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
renderProperties in class CfnResourceprops - This parameter is required.@Stability(value=Stable) @NotNull public String getAttrClientSecret()
@Stability(value=Stable) @NotNull public String getAttrName()
@Stability(value=Stable) @NotNull protected Map<String,Object> getCfnProperties()
getCfnProperties in class CfnResource@Stability(value=Stable) @NotNull public String getUserPoolId()
@Stability(value=Stable)
public void setUserPoolId(@NotNull
String value)
@Stability(value=Stable) @Nullable public Number getAccessTokenValidity()
@Stability(value=Stable)
public void setAccessTokenValidity(@Nullable
Number value)
@Stability(value=Stable) @Nullable public List<String> getAllowedOAuthFlows()
Set to code to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.
Set to implicit to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.
Set to client_credentials to specify that the client should get the access token (and, optionally, ID token, based on scopes) from the token endpoint using a combination of client and client_secret.
@Stability(value=Stable)
public void setAllowedOAuthFlows(@Nullable
List<String> value)
Set to code to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.
Set to implicit to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.
Set to client_credentials to specify that the client should get the access token (and, optionally, ID token, based on scopes) from the token endpoint using a combination of client and client_secret.
@Stability(value=Stable) @Nullable public Object getAllowedOAuthFlowsUserPoolClient()
@Stability(value=Stable)
public void setAllowedOAuthFlowsUserPoolClient(@Nullable
Boolean value)
@Stability(value=Stable)
public void setAllowedOAuthFlowsUserPoolClient(@Nullable
IResolvable value)
@Stability(value=Stable) @Nullable public List<String> getAllowedOAuthScopes()
Possible values provided by OAuth are: phone , email , openid , and profile . Possible values provided by AWS are: aws.cognito.signin.user.admin . Custom scopes created in Resource Servers are also supported.
@Stability(value=Stable)
public void setAllowedOAuthScopes(@Nullable
List<String> value)
Possible values provided by OAuth are: phone , email , openid , and profile . Possible values provided by AWS are: aws.cognito.signin.user.admin . Custom scopes created in Resource Servers are also supported.
@Stability(value=Stable) @Nullable public Object getAnalyticsConfiguration()
In regions where Pinpoint is not available, Cognito User Pools only supports sending events to Amazon Pinpoint projects in us-east-1. In regions where Pinpoint is available, Cognito User Pools will support sending events to Amazon Pinpoint projects within that same region.
@Stability(value=Stable)
public void setAnalyticsConfiguration(@Nullable
CfnUserPoolClient.AnalyticsConfigurationProperty value)
In regions where Pinpoint is not available, Cognito User Pools only supports sending events to Amazon Pinpoint projects in us-east-1. In regions where Pinpoint is available, Cognito User Pools will support sending events to Amazon Pinpoint projects within that same region.
@Stability(value=Stable)
public void setAnalyticsConfiguration(@Nullable
IResolvable value)
In regions where Pinpoint is not available, Cognito User Pools only supports sending events to Amazon Pinpoint projects in us-east-1. In regions where Pinpoint is available, Cognito User Pools will support sending events to Amazon Pinpoint projects within that same region.
@Stability(value=Stable) @Nullable public List<String> getCallbackUrLs()
A redirect URI must:
See OAuth 2.0 - Redirection Endpoint .
Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.
App callback URLs such as myapp://example are also supported.
@Stability(value=Stable)
public void setCallbackUrLs(@Nullable
List<String> value)
A redirect URI must:
See OAuth 2.0 - Redirection Endpoint .
Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.
App callback URLs such as myapp://example are also supported.
@Stability(value=Stable) @Nullable public String getClientName()
@Stability(value=Stable)
public void setClientName(@Nullable
String value)
@Stability(value=Stable) @Nullable public String getDefaultRedirectUri()
A redirect URI must:
See OAuth 2.0 - Redirection Endpoint .
Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.
App callback URLs such as myapp://example are also supported.
@Stability(value=Stable)
public void setDefaultRedirectUri(@Nullable
String value)
A redirect URI must:
See OAuth 2.0 - Redirection Endpoint .
Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.
App callback URLs such as myapp://example are also supported.
@Stability(value=Stable) @Nullable public Object getEnableTokenRevocation()
If you don't include this parameter, token revocation is automatically enabled for the new user pool client.
@Stability(value=Stable)
public void setEnableTokenRevocation(@Nullable
Boolean value)
If you don't include this parameter, token revocation is automatically enabled for the new user pool client.
@Stability(value=Stable)
public void setEnableTokenRevocation(@Nullable
IResolvable value)
If you don't include this parameter, token revocation is automatically enabled for the new user pool client.
@Stability(value=Stable) @Nullable public List<String> getExplicitAuthFlows()
Flow names without the ALLOW_ prefix are deprecated in favor of new names with the ALLOW_ prefix. Note that values with ALLOW_ prefix cannot be used along with values without ALLOW_ prefix.
Valid values include:
ALLOW_ADMIN_USER_PASSWORD_AUTH : Enable admin based user password authentication flow ADMIN_USER_PASSWORD_AUTH . This setting replaces the ADMIN_NO_SRP_AUTH setting. With this authentication flow, Cognito receives the password in the request instead of using the SRP (Secure Remote Password protocol) protocol to verify passwords.ALLOW_CUSTOM_AUTH : Enable Lambda trigger based authentication.ALLOW_USER_PASSWORD_AUTH : Enable user password-based authentication. In this flow, Cognito receives the password in the request instead of using the SRP protocol to verify passwords.ALLOW_USER_SRP_AUTH : Enable SRP based authentication.ALLOW_REFRESH_TOKEN_AUTH : Enable authflow to refresh tokens.@Stability(value=Stable)
public void setExplicitAuthFlows(@Nullable
List<String> value)
Flow names without the ALLOW_ prefix are deprecated in favor of new names with the ALLOW_ prefix. Note that values with ALLOW_ prefix cannot be used along with values without ALLOW_ prefix.
Valid values include:
ALLOW_ADMIN_USER_PASSWORD_AUTH : Enable admin based user password authentication flow ADMIN_USER_PASSWORD_AUTH . This setting replaces the ADMIN_NO_SRP_AUTH setting. With this authentication flow, Cognito receives the password in the request instead of using the SRP (Secure Remote Password protocol) protocol to verify passwords.ALLOW_CUSTOM_AUTH : Enable Lambda trigger based authentication.ALLOW_USER_PASSWORD_AUTH : Enable user password-based authentication. In this flow, Cognito receives the password in the request instead of using the SRP protocol to verify passwords.ALLOW_USER_SRP_AUTH : Enable SRP based authentication.ALLOW_REFRESH_TOKEN_AUTH : Enable authflow to refresh tokens.@Stability(value=Stable) @Nullable public Object getGenerateSecret()
@Stability(value=Stable)
public void setGenerateSecret(@Nullable
Boolean value)
@Stability(value=Stable)
public void setGenerateSecret(@Nullable
IResolvable value)
@Stability(value=Stable) @Nullable public Number getIdTokenValidity()
@Stability(value=Stable)
public void setIdTokenValidity(@Nullable
Number value)
@Stability(value=Stable) @Nullable public List<String> getLogoutUrLs()
@Stability(value=Stable)
public void setLogoutUrLs(@Nullable
List<String> value)
@Stability(value=Stable) @Nullable public String getPreventUserExistenceErrors()
When set to ENABLED and the user does not exist, authentication returns an error indicating either the username or password was incorrect, and account confirmation and password recovery return a response indicating a code was sent to a simulated destination. When set to LEGACY , those APIs will return a UserNotFoundException exception if the user does not exist in the user pool.
@Stability(value=Stable)
public void setPreventUserExistenceErrors(@Nullable
String value)
When set to ENABLED and the user does not exist, authentication returns an error indicating either the username or password was incorrect, and account confirmation and password recovery return a response indicating a code was sent to a simulated destination. When set to LEGACY , those APIs will return a UserNotFoundException exception if the user does not exist in the user pool.
@Stability(value=Stable) @Nullable public List<String> getReadAttributes()
@Stability(value=Stable)
public void setReadAttributes(@Nullable
List<String> value)
@Stability(value=Stable) @Nullable public Number getRefreshTokenValidity()
@Stability(value=Stable)
public void setRefreshTokenValidity(@Nullable
Number value)
@Stability(value=Stable) @Nullable public List<String> getSupportedIdentityProviders()
The following are supported: COGNITO , Facebook , SignInWithApple , Google and LoginWithAmazon .
@Stability(value=Stable)
public void setSupportedIdentityProviders(@Nullable
List<String> value)
The following are supported: COGNITO , Facebook , SignInWithApple , Google and LoginWithAmazon .
@Stability(value=Stable) @Nullable public Object getTokenValidityUnits()
Default for RefreshToken is days, and default for ID and access tokens are hours.
@Stability(value=Stable)
public void setTokenValidityUnits(@Nullable
CfnUserPoolClient.TokenValidityUnitsProperty value)
Default for RefreshToken is days, and default for ID and access tokens are hours.
@Stability(value=Stable)
public void setTokenValidityUnits(@Nullable
IResolvable value)
Default for RefreshToken is days, and default for ID and access tokens are hours.
@Stability(value=Stable) @Nullable public List<String> getWriteAttributes()
If your app client allows users to sign in through an identity provider, this array must include all attributes that are mapped to identity provider attributes. Amazon Cognito updates mapped attributes when users sign in to your application through an identity provider. If your app client lacks write access to a mapped attribute, Amazon Cognito throws an error when it attempts to update the attribute. For more information, see Specifying Identity Provider Attribute Mappings for Your User Pool .
@Stability(value=Stable)
public void setWriteAttributes(@Nullable
List<String> value)
If your app client allows users to sign in through an identity provider, this array must include all attributes that are mapped to identity provider attributes. Amazon Cognito updates mapped attributes when users sign in to your application through an identity provider. If your app client lacks write access to a mapped attribute, Amazon Cognito throws an error when it attempts to update the attribute. For more information, see Specifying Identity Provider Attribute Mappings for Your User Pool .
Copyright © 2022. All rights reserved.