software.amazon.awscdk.services.cognito

Interface OAuthSettings

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

OAuthSettings.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:37.675Z")
 @Stability(value=Stable)
public interface OAuthSettings
extends software.amazon.jsii.JsiiSerializable

OAuth settings to configure the interaction between the app and this client.

Example:

 UserPool userpool = UserPool.Builder.create(this, "UserPool").build();
 UserPoolClient client = userpool.addClient("Client", UserPoolClientOptions.builder()
         // ...
         .oAuth(OAuthSettings.builder()
                 .flows(OAuthFlows.builder()
                         .implicitCodeGrant(true)
                         .build())
                 .callbackUrls(List.of("https://myapp.com/home", "https://myapp.com/users"))
                 .build())
         .build());
 UserPoolDomain domain = userpool.addDomain("Domain", UserPoolDomainOptions.builder().build());
 String signInUrl = domain.signInUrl(client, SignInUrlOptions.builder()
         .redirectUri("https://myapp.com/home")
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	OAuthSettings.Builder A builder for OAuthSettings
static class	OAuthSettings.Jsii$Proxy An implementation for OAuthSettings

Method Summary

Modifier and Type	Method and Description
static OAuthSettings.Builder	builder()
default List<String>	getCallbackUrls() List of allowed redirect URLs for the identity providers.
default OAuthFlows	getFlows() OAuth flows that are allowed with this client.
default List<String>	getLogoutUrls() List of allowed logout URLs for the identity providers.
default List<OAuthScope>	getScopes() OAuth scopes that are allowed with this client.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getCallbackUrls

@Stability(value=Stable)
 @Nullable
default List<String> getCallbackUrls()

List of allowed redirect URLs for the identity providers.

Default: - ['https://example.com'] if either authorizationCodeGrant or implicitCodeGrant flows are enabled, no callback URLs otherwise.

getFlows

@Stability(value=Stable)
 @Nullable
default OAuthFlows getFlows()

OAuth flows that are allowed with this client.

Default: {authorizationCodeGrant:true,implicitCodeGrant:true}

See Also:

- the 'Allowed OAuth Flows' section at https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-app-idp-settings.html

getLogoutUrls

@Stability(value=Stable)
 @Nullable
default List<String> getLogoutUrls()

List of allowed logout URLs for the identity providers.

Default: - no logout URLs

getScopes

@Stability(value=Stable)
 @Nullable
default List<OAuthScope> getScopes()

OAuth scopes that are allowed with this client.

Default: [OAuthScope.PHONE,OAuthScope.EMAIL,OAuthScope.OPENID,OAuthScope.PROFILE,OAuthScope.COGNITO_ADMIN]

See Also:

https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-app-idp-settings.html

builder

@Stability(value=Stable)
static OAuthSettings.Builder builder()

Returns:

a OAuthSettings.Builder of OAuthSettings