@aws-sdk/client-cognito-identity-provider 3.47.2 → 3.51.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +35 -0
- package/README.md +3 -7
- package/dist-types/CognitoIdentityProvider.d.ts +367 -457
- package/dist-types/CognitoIdentityProviderClient.d.ts +3 -7
- package/dist-types/commands/AdminConfirmSignUpCommand.d.ts +1 -2
- package/dist-types/commands/AdminCreateUserCommand.d.ts +20 -23
- package/dist-types/commands/AdminDeleteUserAttributesCommand.d.ts +1 -2
- package/dist-types/commands/AdminDisableProviderForUserCommand.d.ts +14 -28
- package/dist-types/commands/AdminGetUserCommand.d.ts +1 -2
- package/dist-types/commands/AdminInitiateAuthCommand.d.ts +14 -14
- package/dist-types/commands/AdminLinkProviderForUserCommand.d.ts +12 -19
- package/dist-types/commands/AdminListUserAuthEventsCommand.d.ts +1 -2
- package/dist-types/commands/AdminResetUserPasswordCommand.d.ts +20 -24
- package/dist-types/commands/AdminRespondToAuthChallengeCommand.d.ts +14 -14
- package/dist-types/commands/AdminSetUserMFAPreferenceCommand.d.ts +3 -5
- package/dist-types/commands/AdminSetUserPasswordCommand.d.ts +5 -10
- package/dist-types/commands/AdminSetUserSettingsCommand.d.ts +3 -3
- package/dist-types/commands/AdminUpdateAuthEventFeedbackCommand.d.ts +2 -3
- package/dist-types/commands/AdminUpdateUserAttributesCommand.d.ts +17 -20
- package/dist-types/commands/AdminUserGlobalSignOutCommand.d.ts +2 -3
- package/dist-types/commands/AssociateSoftwareTokenCommand.d.ts +6 -10
- package/dist-types/commands/ConfirmDeviceCommand.d.ts +1 -2
- package/dist-types/commands/ConfirmSignUpCommand.d.ts +1 -2
- package/dist-types/commands/CreateResourceServerCommand.d.ts +1 -1
- package/dist-types/commands/CreateUserPoolClientCommand.d.ts +2 -2
- package/dist-types/commands/CreateUserPoolCommand.d.ts +16 -16
- package/dist-types/commands/DescribeUserPoolClientCommand.d.ts +1 -2
- package/dist-types/commands/ForgotPasswordCommand.d.ts +23 -22
- package/dist-types/commands/GetCSVHeaderCommand.d.ts +1 -2
- package/dist-types/commands/GetUICustomizationCommand.d.ts +2 -4
- package/dist-types/commands/GetUserAttributeVerificationCodeCommand.d.ts +15 -14
- package/dist-types/commands/GlobalSignOutCommand.d.ts +2 -3
- package/dist-types/commands/InitiateAuthCommand.d.ts +14 -14
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +1 -2
- package/dist-types/commands/ListUserPoolsCommand.d.ts +1 -1
- package/dist-types/commands/ResendConfirmationCodeCommand.d.ts +16 -16
- package/dist-types/commands/RespondToAuthChallengeCommand.d.ts +14 -14
- package/dist-types/commands/RevokeTokenCommand.d.ts +1 -2
- package/dist-types/commands/SetRiskConfigurationCommand.d.ts +2 -5
- package/dist-types/commands/SetUICustomizationCommand.d.ts +7 -12
- package/dist-types/commands/SetUserMFAPreferenceCommand.d.ts +6 -9
- package/dist-types/commands/SetUserPoolMfaConfigCommand.d.ts +17 -17
- package/dist-types/commands/SetUserSettingsCommand.d.ts +2 -3
- package/dist-types/commands/SignUpCommand.d.ts +16 -16
- package/dist-types/commands/TagResourceCommand.d.ts +7 -14
- package/dist-types/commands/UntagResourceCommand.d.ts +1 -2
- package/dist-types/commands/UpdateAuthEventFeedbackCommand.d.ts +2 -3
- package/dist-types/commands/UpdateResourceServerCommand.d.ts +3 -4
- package/dist-types/commands/UpdateUserAttributesCommand.d.ts +15 -14
- package/dist-types/commands/UpdateUserPoolClientCommand.d.ts +7 -8
- package/dist-types/commands/UpdateUserPoolCommand.d.ts +18 -17
- package/dist-types/commands/UpdateUserPoolDomainCommand.d.ts +11 -20
- package/dist-types/commands/VerifySoftwareTokenCommand.d.ts +2 -3
- package/dist-types/models/models_0.d.ts +1409 -2027
- package/dist-types/models/models_1.d.ts +125 -192
- package/package.json +39 -33
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
import { MetadataBearer as $MetadataBearer, SmithyException as __SmithyException } from "@aws-sdk/types";
|
|
2
2
|
import { AccountRecoverySettingType, AdminCreateUserConfigType, AnalyticsConfigurationType, AttributeType, CodeDeliveryDetailsType, CustomDomainConfigType, DeviceConfigurationType, DeviceRememberedStatusType, EmailConfigurationType, ExplicitAuthFlowsType, FeedbackValueType, GroupType, IdentityProviderType, LambdaConfigType, OAuthFlowType, PreventUserExistenceErrorTypes, ResourceServerScopeType, ResourceServerType, SmsConfigurationType, TokenValidityUnitsType, UserImportJobType, UserPoolAddOnsType, UserPoolClientType, UserPoolMfaType, UserPoolPolicyType, VerificationMessageTemplateType, VerifiedAttributeType } from "./models_0";
|
|
3
3
|
/**
|
|
4
|
-
* <p>Represents the response from the server to the request to start the user import
|
|
5
|
-
* job.</p>
|
|
4
|
+
* <p>Represents the response from the server to the request to start the user import job.</p>
|
|
6
5
|
*/
|
|
7
6
|
export interface StartUserImportJobResponse {
|
|
8
7
|
/**
|
|
@@ -21,7 +20,8 @@ export declare namespace StartUserImportJobResponse {
|
|
|
21
20
|
*/
|
|
22
21
|
export interface StopUserImportJobRequest {
|
|
23
22
|
/**
|
|
24
|
-
* <p>The user pool ID for the user pool that the users are being imported
|
|
23
|
+
* <p>The user pool ID for the user pool that the users are being imported
|
|
24
|
+
* into.</p>
|
|
25
25
|
*/
|
|
26
26
|
UserPoolId: string | undefined;
|
|
27
27
|
/**
|
|
@@ -36,8 +36,7 @@ export declare namespace StopUserImportJobRequest {
|
|
|
36
36
|
const filterSensitiveLog: (obj: StopUserImportJobRequest) => any;
|
|
37
37
|
}
|
|
38
38
|
/**
|
|
39
|
-
* <p>Represents the response from the server to the request to stop the user import
|
|
40
|
-
* job.</p>
|
|
39
|
+
* <p>Represents the response from the server to the request to stop the user import job.</p>
|
|
41
40
|
*/
|
|
42
41
|
export interface StopUserImportJobResponse {
|
|
43
42
|
/**
|
|
@@ -185,14 +184,12 @@ export interface UpdateGroupRequest {
|
|
|
185
184
|
*/
|
|
186
185
|
Description?: string;
|
|
187
186
|
/**
|
|
188
|
-
* <p>The new role ARN for the group. This is used for setting the
|
|
189
|
-
* <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims in the
|
|
190
|
-
* token.</p>
|
|
187
|
+
* <p>The new role Amazon Resource Name (ARN) for the group. This is used for setting the <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims in the token.</p>
|
|
191
188
|
*/
|
|
192
189
|
RoleArn?: string;
|
|
193
190
|
/**
|
|
194
|
-
* <p>The new precedence value for the group. For more information about this parameter,
|
|
195
|
-
*
|
|
191
|
+
* <p>The new precedence value for the group. For more information about this parameter,
|
|
192
|
+
* see <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateGroup.html">CreateGroup</a>.</p>
|
|
196
193
|
*/
|
|
197
194
|
Precedence?: number;
|
|
198
195
|
}
|
|
@@ -224,8 +221,7 @@ export interface UpdateIdentityProviderRequest {
|
|
|
224
221
|
*/
|
|
225
222
|
ProviderName: string | undefined;
|
|
226
223
|
/**
|
|
227
|
-
* <p>The identity provider details to be updated, such as <code>MetadataURL</code> and
|
|
228
|
-
* <code>MetadataFile</code>.</p>
|
|
224
|
+
* <p>The identity provider details to be updated, such as <code>MetadataURL</code> and <code>MetadataFile</code>.</p>
|
|
229
225
|
*/
|
|
230
226
|
ProviderDetails?: {
|
|
231
227
|
[key: string]: string;
|
|
@@ -301,8 +297,7 @@ export declare namespace UpdateResourceServerResponse {
|
|
|
301
297
|
export interface UpdateUserAttributesRequest {
|
|
302
298
|
/**
|
|
303
299
|
* <p>An array of name-value pairs representing user attributes.</p>
|
|
304
|
-
* <p>For custom attributes, you must prepend the <code>custom:</code> prefix to the
|
|
305
|
-
* attribute name.</p>
|
|
300
|
+
* <p>For custom attributes, you must prepend the <code>custom:</code> prefix to the attribute name.</p>
|
|
306
301
|
*/
|
|
307
302
|
UserAttributes: AttributeType[] | undefined;
|
|
308
303
|
/**
|
|
@@ -310,37 +305,31 @@ export interface UpdateUserAttributesRequest {
|
|
|
310
305
|
*/
|
|
311
306
|
AccessToken: string | undefined;
|
|
312
307
|
/**
|
|
313
|
-
* <p>A map of custom key-value pairs that you can provide as input for any custom workflows
|
|
314
|
-
*
|
|
315
|
-
*
|
|
316
|
-
*
|
|
317
|
-
*
|
|
318
|
-
*
|
|
319
|
-
* This payload contains a <code>clientMetadata</code> attribute, which provides the data
|
|
320
|
-
* that you assigned to the ClientMetadata parameter in your UpdateUserAttributes request.
|
|
321
|
-
* In your function code in Lambda, you can process the <code>clientMetadata</code>
|
|
308
|
+
* <p>A map of custom key-value pairs that you can provide as input for any custom workflows that this action initiates. </p>
|
|
309
|
+
* <p>You create custom workflows by assigning Lambda functions to user pool triggers. When you use the UpdateUserAttributes API action, Amazon Cognito invokes the
|
|
310
|
+
* function that is assigned to the <i>custom message</i> trigger. When Amazon Cognito invokes this function, it passes a
|
|
311
|
+
* JSON
|
|
312
|
+
* payload, which the function receives as input. This payload contains a <code>clientMetadata</code> attribute, which provides the data that you
|
|
313
|
+
* assigned to the ClientMetadata parameter in your UpdateUserAttributes request. In your function code in Lambda, you can process the <code>clientMetadata</code>
|
|
322
314
|
* value to enhance your workflow for your specific needs.</p>
|
|
323
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html">Customizing User Pool
|
|
324
|
-
*
|
|
325
|
-
*
|
|
326
|
-
*
|
|
327
|
-
*
|
|
315
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html">Customizing User Pool
|
|
316
|
+
* Workflows with Lambda Triggers</a> in the <i>Amazon Cognito Developer Guide</i>.</p>
|
|
317
|
+
*
|
|
318
|
+
* <note>
|
|
319
|
+
* <p>When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following:</p>
|
|
328
320
|
* <ul>
|
|
329
321
|
* <li>
|
|
330
|
-
*
|
|
331
|
-
*
|
|
332
|
-
*
|
|
333
|
-
* triggers, the ClientMetadata parameter serves no purpose.</p>
|
|
334
|
-
* </li>
|
|
322
|
+
* <p>Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool to support custom workflows. If your user pool
|
|
323
|
+
* configuration doesn't include triggers, the ClientMetadata parameter serves no purpose.</p>
|
|
324
|
+
* </li>
|
|
335
325
|
* <li>
|
|
336
|
-
*
|
|
337
|
-
*
|
|
326
|
+
* <p>Validate the ClientMetadata value.</p>
|
|
327
|
+
* </li>
|
|
338
328
|
* <li>
|
|
339
|
-
*
|
|
340
|
-
*
|
|
341
|
-
* </li>
|
|
329
|
+
* <p>Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information.</p>
|
|
330
|
+
* </li>
|
|
342
331
|
* </ul>
|
|
343
|
-
*
|
|
332
|
+
* </note>
|
|
344
333
|
*/
|
|
345
334
|
ClientMetadata?: {
|
|
346
335
|
[key: string]: string;
|
|
@@ -353,13 +342,11 @@ export declare namespace UpdateUserAttributesRequest {
|
|
|
353
342
|
const filterSensitiveLog: (obj: UpdateUserAttributesRequest) => any;
|
|
354
343
|
}
|
|
355
344
|
/**
|
|
356
|
-
* <p>Represents the response from the server for the request to update user
|
|
357
|
-
* attributes.</p>
|
|
345
|
+
* <p>Represents the response from the server for the request to update user attributes.</p>
|
|
358
346
|
*/
|
|
359
347
|
export interface UpdateUserAttributesResponse {
|
|
360
348
|
/**
|
|
361
|
-
* <p>The code delivery details list from the server for the request to update user
|
|
362
|
-
* attributes.</p>
|
|
349
|
+
* <p>The code delivery details list from the server for the request to update user attributes.</p>
|
|
363
350
|
*/
|
|
364
351
|
CodeDeliveryDetailsList?: CodeDeliveryDetailsType[];
|
|
365
352
|
}
|
|
@@ -378,17 +365,15 @@ export interface UpdateUserPoolRequest {
|
|
|
378
365
|
*/
|
|
379
366
|
UserPoolId: string | undefined;
|
|
380
367
|
/**
|
|
381
|
-
* <p>A container with the policies you
|
|
368
|
+
* <p>A container with the policies you want to update in a user pool.</p>
|
|
382
369
|
*/
|
|
383
370
|
Policies?: UserPoolPolicyType;
|
|
384
371
|
/**
|
|
385
|
-
* <p>The Lambda configuration information from the request to update the user
|
|
386
|
-
* pool.</p>
|
|
372
|
+
* <p>The Lambda configuration information from the request to update the user pool.</p>
|
|
387
373
|
*/
|
|
388
374
|
LambdaConfig?: LambdaConfigType;
|
|
389
375
|
/**
|
|
390
|
-
* <p>The attributes that are automatically verified when
|
|
391
|
-
* request to update user pools.</p>
|
|
376
|
+
* <p>The attributes that are automatically verified when Amazon Cognito requests to update user pools.</p>
|
|
392
377
|
*/
|
|
393
378
|
AutoVerifiedAttributes?: (VerifiedAttributeType | string)[];
|
|
394
379
|
/**
|
|
@@ -413,23 +398,21 @@ export interface UpdateUserPoolRequest {
|
|
|
413
398
|
SmsAuthenticationMessage?: string;
|
|
414
399
|
/**
|
|
415
400
|
* <p>Can be one of the following values:</p>
|
|
416
|
-
*
|
|
401
|
+
*
|
|
402
|
+
* <ul>
|
|
417
403
|
* <li>
|
|
418
|
-
*
|
|
419
|
-
*
|
|
420
|
-
* user registration.</p>
|
|
404
|
+
* <p>
|
|
405
|
+
* <code>OFF</code> - MFA tokens aren't required and can't be specified during user registration.</p>
|
|
421
406
|
* </li>
|
|
422
407
|
* <li>
|
|
423
|
-
*
|
|
424
|
-
*
|
|
425
|
-
*
|
|
426
|
-
*
|
|
427
|
-
* user pools. </p>
|
|
408
|
+
* <p>
|
|
409
|
+
* <code>ON</code> - MFA tokens are required for all user registrations. You can only specify ON when you're initially creating a user pool. You can
|
|
410
|
+
* use the <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SetUserPoolMfaConfig.html">SetUserPoolMfaConfig</a> API operation
|
|
411
|
+
* to turn MFA "ON" for existing user pools. </p>
|
|
428
412
|
* </li>
|
|
429
413
|
* <li>
|
|
430
|
-
*
|
|
431
|
-
*
|
|
432
|
-
* token.</p>
|
|
414
|
+
* <p>
|
|
415
|
+
* <code>OPTIONAL</code> - Users have the option when registering to create an MFA token.</p>
|
|
433
416
|
* </li>
|
|
434
417
|
* </ul>
|
|
435
418
|
*/
|
|
@@ -447,9 +430,8 @@ export interface UpdateUserPoolRequest {
|
|
|
447
430
|
*/
|
|
448
431
|
SmsConfiguration?: SmsConfigurationType;
|
|
449
432
|
/**
|
|
450
|
-
* <p>The tag keys and values to assign to the user pool. A tag is a label that you can use
|
|
451
|
-
*
|
|
452
|
-
* environment, or other criteria.</p>
|
|
433
|
+
* <p>The tag keys and values to assign to the user pool. A tag is a label that you can use to categorize and manage user pools in different ways, such as by purpose, owner, environment,
|
|
434
|
+
* or other criteria.</p>
|
|
453
435
|
*/
|
|
454
436
|
UserPoolTags?: {
|
|
455
437
|
[key: string]: string;
|
|
@@ -459,17 +441,14 @@ export interface UpdateUserPoolRequest {
|
|
|
459
441
|
*/
|
|
460
442
|
AdminCreateUserConfig?: AdminCreateUserConfigType;
|
|
461
443
|
/**
|
|
462
|
-
* <p>
|
|
463
|
-
* <code>AdvancedSecurityMode</code> to the value "AUDIT".</p>
|
|
444
|
+
* <p>Enables advanced security risk detection. Set the key <code>AdvancedSecurityMode</code> to the value "AUDIT".</p>
|
|
464
445
|
*/
|
|
465
446
|
UserPoolAddOns?: UserPoolAddOnsType;
|
|
466
447
|
/**
|
|
467
|
-
* <p>
|
|
468
|
-
*
|
|
469
|
-
*
|
|
470
|
-
*
|
|
471
|
-
* enabled. In the absence of this setting, Cognito uses the legacy behavior to determine
|
|
472
|
-
* the recovery method where SMS is preferred over email.</p>
|
|
448
|
+
* <p>The available verified method a user can use to recover their password when they call <code>ForgotPassword</code>. You can use this setting to define a
|
|
449
|
+
* preferred method when a user has more than one method available. With this setting, SMS doesn't qualify for a valid password recovery mechanism if the user
|
|
450
|
+
* also has SMS multi-factor authentication (MFA) activated. In the absence of this setting, Amazon Cognito uses the legacy behavior to determine the recovery method
|
|
451
|
+
* where SMS is preferred through email.</p>
|
|
473
452
|
*/
|
|
474
453
|
AccountRecoverySetting?: AccountRecoverySettingType;
|
|
475
454
|
}
|
|
@@ -480,8 +459,7 @@ export declare namespace UpdateUserPoolRequest {
|
|
|
480
459
|
const filterSensitiveLog: (obj: UpdateUserPoolRequest) => any;
|
|
481
460
|
}
|
|
482
461
|
/**
|
|
483
|
-
* <p>Represents the response from the server when you make a request to update the user
|
|
484
|
-
* pool.</p>
|
|
462
|
+
* <p>Represents the response from the server when you make a request to update the user pool.</p>
|
|
485
463
|
*/
|
|
486
464
|
export interface UpdateUserPoolResponse {
|
|
487
465
|
}
|
|
@@ -496,8 +474,7 @@ export declare namespace UpdateUserPoolResponse {
|
|
|
496
474
|
*/
|
|
497
475
|
export interface UpdateUserPoolClientRequest {
|
|
498
476
|
/**
|
|
499
|
-
* <p>The user pool ID for the user pool where you want to update the user pool
|
|
500
|
-
* client.</p>
|
|
477
|
+
* <p>The user pool ID for the user pool where you want to update the user pool client.</p>
|
|
501
478
|
*/
|
|
502
479
|
UserPoolId: string | undefined;
|
|
503
480
|
/**
|
|
@@ -509,22 +486,19 @@ export interface UpdateUserPoolClientRequest {
|
|
|
509
486
|
*/
|
|
510
487
|
ClientName?: string;
|
|
511
488
|
/**
|
|
512
|
-
* <p>The time limit, in days, after which the refresh token is no longer valid and
|
|
513
|
-
* be used.</p>
|
|
489
|
+
* <p>The time limit, in days, after which the refresh token is no longer valid and can't be used.</p>
|
|
514
490
|
*/
|
|
515
491
|
RefreshTokenValidity?: number;
|
|
516
492
|
/**
|
|
517
|
-
* <p>The time limit
|
|
518
|
-
* used.</p>
|
|
493
|
+
* <p>The time limit after which the access token is no longer valid and can't be used.</p>
|
|
519
494
|
*/
|
|
520
495
|
AccessTokenValidity?: number;
|
|
521
496
|
/**
|
|
522
|
-
* <p>The time limit
|
|
497
|
+
* <p>The time limit after which the ID token is no longer valid and can't be used.</p>
|
|
523
498
|
*/
|
|
524
499
|
IdTokenValidity?: number;
|
|
525
500
|
/**
|
|
526
|
-
* <p>The units in which the validity times are represented
|
|
527
|
-
* days, and default for ID and access tokens are hours.</p>
|
|
501
|
+
* <p>The units in which the validity times are represented. Default for RefreshToken is days, and default for ID and access tokens is hours.</p>
|
|
528
502
|
*/
|
|
529
503
|
TokenValidityUnits?: TokenValidityUnitsType;
|
|
530
504
|
/**
|
|
@@ -536,67 +510,58 @@ export interface UpdateUserPoolClientRequest {
|
|
|
536
510
|
*/
|
|
537
511
|
WriteAttributes?: string[];
|
|
538
512
|
/**
|
|
539
|
-
* <p>The authentication flows that are supported by the user pool clients. Flow names
|
|
540
|
-
*
|
|
541
|
-
* <code>ALLOW_</code> prefix. Note that values with <code>ALLOW_</code> prefix cannot
|
|
542
|
-
* be used along with values without <code>ALLOW_</code> prefix.</p>
|
|
513
|
+
* <p>The authentication flows that are supported by the user pool clients. Flow names without the <code>ALLOW_</code> prefix are no longer supported in favor of new names with the
|
|
514
|
+
* <code>ALLOW_</code> prefix. Note that values with <code>ALLOW_</code> prefix must be used only along with values with the <code>ALLOW_</code> prefix.</p>
|
|
543
515
|
* <p>Valid values include:</p>
|
|
544
|
-
*
|
|
516
|
+
* <ul>
|
|
545
517
|
* <li>
|
|
546
|
-
*
|
|
547
|
-
* <code>ALLOW_ADMIN_USER_PASSWORD_AUTH</code>: Enable admin based user password
|
|
548
|
-
*
|
|
549
|
-
*
|
|
550
|
-
* Cognito receives the password in the request instead of using the SRP (Secure
|
|
551
|
-
* Remote Password protocol) protocol to verify passwords.</p>
|
|
518
|
+
* <p>
|
|
519
|
+
* <code>ALLOW_ADMIN_USER_PASSWORD_AUTH</code>: Enable admin based user password authentication flow <code>ADMIN_USER_PASSWORD_AUTH</code>. This setting replaces the
|
|
520
|
+
* <code>ADMIN_NO_SRP_AUTH</code> setting. With this authentication flow, Amazon Cognito receives the password in the request instead of using the Secure Remote Password (SRP) protocol to
|
|
521
|
+
* verify passwords.</p>
|
|
552
522
|
* </li>
|
|
553
523
|
* <li>
|
|
554
|
-
*
|
|
555
|
-
* <code>ALLOW_CUSTOM_AUTH</code>: Enable Lambda trigger based
|
|
556
|
-
* authentication.</p>
|
|
524
|
+
* <p>
|
|
525
|
+
* <code>ALLOW_CUSTOM_AUTH</code>: Enable Lambda trigger based authentication.</p>
|
|
557
526
|
* </li>
|
|
558
527
|
* <li>
|
|
559
|
-
*
|
|
560
|
-
* <code>ALLOW_USER_PASSWORD_AUTH</code>: Enable user password-based
|
|
561
|
-
*
|
|
562
|
-
* instead of using the SRP protocol to verify passwords.</p>
|
|
528
|
+
* <p>
|
|
529
|
+
* <code>ALLOW_USER_PASSWORD_AUTH</code>: Enable user password-based authentication. In this flow, Amazon Cognito receives the password in the request instead of using the SRP
|
|
530
|
+
* protocol to verify passwords.</p>
|
|
563
531
|
* </li>
|
|
564
532
|
* <li>
|
|
565
|
-
*
|
|
566
|
-
* <code>ALLOW_USER_SRP_AUTH</code>: Enable SRP
|
|
533
|
+
* <p>
|
|
534
|
+
* <code>ALLOW_USER_SRP_AUTH</code>: Enable SRP-based authentication.</p>
|
|
567
535
|
* </li>
|
|
568
536
|
* <li>
|
|
569
|
-
*
|
|
570
|
-
* <code>ALLOW_REFRESH_TOKEN_AUTH</code>: Enable authflow to refresh
|
|
571
|
-
* tokens.</p>
|
|
537
|
+
* <p>
|
|
538
|
+
* <code>ALLOW_REFRESH_TOKEN_AUTH</code>: Enable authflow to refresh tokens.</p>
|
|
572
539
|
* </li>
|
|
573
540
|
* </ul>
|
|
574
541
|
*/
|
|
575
542
|
ExplicitAuthFlows?: (ExplicitAuthFlowsType | string)[];
|
|
576
543
|
/**
|
|
577
|
-
* <p>A list of provider names for the identity providers that are supported on this
|
|
578
|
-
* client.</p>
|
|
544
|
+
* <p>A list of provider names for the identity providers that are supported on this client.</p>
|
|
579
545
|
*/
|
|
580
546
|
SupportedIdentityProviders?: string[];
|
|
581
547
|
/**
|
|
582
548
|
* <p>A list of allowed redirect (callback) URLs for the identity providers.</p>
|
|
583
549
|
* <p>A redirect URI must:</p>
|
|
584
|
-
*
|
|
550
|
+
* <ul>
|
|
585
551
|
* <li>
|
|
586
|
-
*
|
|
552
|
+
* <p>Be an absolute URI.</p>
|
|
587
553
|
* </li>
|
|
588
554
|
* <li>
|
|
589
|
-
*
|
|
555
|
+
* <p>Be registered with the authorization server.</p>
|
|
590
556
|
* </li>
|
|
591
557
|
* <li>
|
|
592
|
-
*
|
|
558
|
+
* <p>Not include a
|
|
559
|
+
* fragment component.</p>
|
|
593
560
|
* </li>
|
|
594
561
|
* </ul>
|
|
595
|
-
* <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 -
|
|
596
|
-
*
|
|
597
|
-
* <p>
|
|
598
|
-
* purposes only.</p>
|
|
599
|
-
* <p>App callback URLs such as myapp://example are also supported.</p>
|
|
562
|
+
* <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 - Redirection Endpoint</a>.</p>
|
|
563
|
+
* <p>Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.</p>
|
|
564
|
+
* <p>App callback URLs such as <code>myapp://example</code> are also supported.</p>
|
|
600
565
|
*/
|
|
601
566
|
CallbackURLs?: string[];
|
|
602
567
|
/**
|
|
@@ -606,92 +571,71 @@ export interface UpdateUserPoolClientRequest {
|
|
|
606
571
|
/**
|
|
607
572
|
* <p>The default redirect URI. Must be in the <code>CallbackURLs</code> list.</p>
|
|
608
573
|
* <p>A redirect URI must:</p>
|
|
609
|
-
*
|
|
574
|
+
* <ul>
|
|
610
575
|
* <li>
|
|
611
|
-
*
|
|
576
|
+
* <p>Be an absolute URI.</p>
|
|
612
577
|
* </li>
|
|
613
578
|
* <li>
|
|
614
|
-
*
|
|
579
|
+
* <p>Be registered with the authorization server.</p>
|
|
615
580
|
* </li>
|
|
616
581
|
* <li>
|
|
617
|
-
*
|
|
582
|
+
* <p>Not include a
|
|
583
|
+
* fragment component.</p>
|
|
618
584
|
* </li>
|
|
619
585
|
* </ul>
|
|
620
|
-
* <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 -
|
|
621
|
-
*
|
|
622
|
-
* <p>
|
|
623
|
-
* purposes only.</p>
|
|
624
|
-
* <p>App callback URLs such as myapp://example are also supported.</p>
|
|
586
|
+
* <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 - Redirection Endpoint</a>.</p>
|
|
587
|
+
* <p>Amazon Cognito requires HTTPS over HTTP except for <code>http://localhost</code> for testing purposes only.</p>
|
|
588
|
+
* <p>App callback URLs such as <code>myapp://example</code> are also supported.</p>
|
|
625
589
|
*/
|
|
626
590
|
DefaultRedirectURI?: string;
|
|
627
591
|
/**
|
|
628
592
|
* <p>The allowed OAuth flows.</p>
|
|
629
|
-
* <p>Set to <code>code</code> to initiate a code grant flow, which provides an
|
|
630
|
-
*
|
|
631
|
-
*
|
|
632
|
-
*
|
|
633
|
-
* (and, optionally, ID token, based on scopes) directly.</p>
|
|
634
|
-
* <p>Set to <code>client_credentials</code> to specify that the client should get the
|
|
635
|
-
* access token (and, optionally, ID token, based on scopes) from the token endpoint using
|
|
636
|
-
* a combination of client and client_secret.</p>
|
|
593
|
+
* <p>Set to <code>code</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.</p>
|
|
594
|
+
* <p>Set to <code>implicit</code> to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.</p>
|
|
595
|
+
* <p>Set to <code>client_credentials</code> to specify that the client should get the access token (and, optionally, ID token, based on scopes) from the token endpoint using a combination
|
|
596
|
+
* of client and client_secret.</p>
|
|
637
597
|
*/
|
|
638
598
|
AllowedOAuthFlows?: (OAuthFlowType | string)[];
|
|
639
599
|
/**
|
|
640
600
|
* <p>The allowed OAuth scopes. Possible values provided by OAuth are: <code>phone</code>,
|
|
641
|
-
*
|
|
642
|
-
* provided by Amazon Web Services are: <code>aws.cognito.signin.user.admin</code>. Custom scopes created
|
|
601
|
+
* <code>email</code>, <code>openid</code>, and <code>profile</code>. Possible values provided by Amazon Web Services are: <code>aws.cognito.signin.user.admin</code>. Custom scopes created
|
|
643
602
|
* in Resource Servers are also supported.</p>
|
|
644
603
|
*/
|
|
645
604
|
AllowedOAuthScopes?: string[];
|
|
646
605
|
/**
|
|
647
|
-
* <p>Set to true if the client is allowed to follow the OAuth protocol when interacting
|
|
648
|
-
* with Cognito user pools.</p>
|
|
606
|
+
* <p>Set to true if the client is allowed to follow the OAuth protocol when interacting with Amazon Cognito user pools.</p>
|
|
649
607
|
*/
|
|
650
608
|
AllowedOAuthFlowsUserPoolClient?: boolean;
|
|
651
609
|
/**
|
|
652
|
-
* <p>The Amazon Pinpoint analytics configuration for collecting metrics for this user
|
|
653
|
-
*
|
|
654
|
-
*
|
|
655
|
-
*
|
|
656
|
-
*
|
|
657
|
-
* is available, Cognito User Pools will support sending events to Amazon Pinpoint
|
|
658
|
-
* projects within that same region. </p>
|
|
659
|
-
* </note>
|
|
610
|
+
* <p>The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.</p>
|
|
611
|
+
* <note>
|
|
612
|
+
* <p>In Amazon Web Services Regions where isn't available, User Pools only supports sending events to Amazon Pinpoint projects in us-east-1. In Regions where Pinpoint is available, User Pools will support
|
|
613
|
+
* sending events to Amazon Pinpoint projects within that same Region. </p>
|
|
614
|
+
* </note>
|
|
660
615
|
*/
|
|
661
616
|
AnalyticsConfiguration?: AnalyticsConfigurationType;
|
|
662
617
|
/**
|
|
663
|
-
* <p>
|
|
664
|
-
*
|
|
665
|
-
*
|
|
666
|
-
*
|
|
667
|
-
* incorrect, and account confirmation and password recovery return a response indicating a
|
|
668
|
-
* code was sent to a simulated destination. When set to <code>LEGACY</code>, those APIs
|
|
669
|
-
* will return a <code>UserNotFoundException</code> exception if the user does not exist in
|
|
670
|
-
* the user pool.</p>
|
|
618
|
+
* <p>Errors and responses that you want Amazon Cognito APIs to return during authentication, account confirmation, and password recovery when the user doesn't exist in the
|
|
619
|
+
* user pool. When set to <code>ENABLED</code> and the user doesn't exist, authentication returns an error indicating either the username or password was incorrect.
|
|
620
|
+
* Account confirmation and password recovery return a response indicating a code was sent to a simulated destination. When set to <code>LEGACY</code>, those APIs
|
|
621
|
+
* return a <code>UserNotFoundException</code> exception if the user doesn't exist in the user pool.</p>
|
|
671
622
|
* <p>Valid values include:</p>
|
|
672
|
-
*
|
|
623
|
+
* <ul>
|
|
673
624
|
* <li>
|
|
674
|
-
*
|
|
625
|
+
* <p>
|
|
675
626
|
* <code>ENABLED</code> - This prevents user existence-related errors.</p>
|
|
676
627
|
* </li>
|
|
677
628
|
* <li>
|
|
678
|
-
*
|
|
679
|
-
* <code>LEGACY</code> - This represents the
|
|
680
|
-
*
|
|
629
|
+
* <p>
|
|
630
|
+
* <code>LEGACY</code> - This represents the early
|
|
631
|
+
* behavior of Amazon Cognito where user existence related errors aren't prevented.</p>
|
|
681
632
|
* </li>
|
|
682
633
|
* </ul>
|
|
683
|
-
*
|
|
684
|
-
*
|
|
685
|
-
* <note>
|
|
686
|
-
* <p>After February 15th 2020, the value of <code>PreventUserExistenceErrors</code>
|
|
687
|
-
* will default to <code>ENABLED</code> for newly created user pool clients if no value
|
|
688
|
-
* is provided.</p>
|
|
689
|
-
* </note>
|
|
690
634
|
*/
|
|
691
635
|
PreventUserExistenceErrors?: PreventUserExistenceErrorTypes | string;
|
|
692
636
|
/**
|
|
693
|
-
* <p>
|
|
694
|
-
*
|
|
637
|
+
* <p>Activates or deactivates token revocation. For more information about revoking tokens,
|
|
638
|
+
* see <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_RevokeToken.html">RevokeToken</a>.</p>
|
|
695
639
|
*/
|
|
696
640
|
EnableTokenRevocation?: boolean;
|
|
697
641
|
}
|
|
@@ -702,13 +646,11 @@ export declare namespace UpdateUserPoolClientRequest {
|
|
|
702
646
|
const filterSensitiveLog: (obj: UpdateUserPoolClientRequest) => any;
|
|
703
647
|
}
|
|
704
648
|
/**
|
|
705
|
-
* <p>Represents the response from the server to the request to update the user pool
|
|
706
|
-
* client.</p>
|
|
649
|
+
* <p>Represents the response from the server to the request to update the user pool client.</p>
|
|
707
650
|
*/
|
|
708
651
|
export interface UpdateUserPoolClientResponse {
|
|
709
652
|
/**
|
|
710
|
-
* <p>The user pool client value from the response from the server when
|
|
711
|
-
* client request is made.</p>
|
|
653
|
+
* <p>The user pool client value from the response from the server when you request to update the user pool client.</p>
|
|
712
654
|
*/
|
|
713
655
|
UserPoolClient?: UserPoolClientType;
|
|
714
656
|
}
|
|
@@ -723,21 +665,16 @@ export declare namespace UpdateUserPoolClientResponse {
|
|
|
723
665
|
*/
|
|
724
666
|
export interface UpdateUserPoolDomainRequest {
|
|
725
667
|
/**
|
|
726
|
-
* <p>The domain name for the custom domain that hosts the sign-up and sign-in pages for
|
|
727
|
-
*
|
|
728
|
-
* <p>This string can include only lowercase letters, numbers, and hyphens. Do not use a
|
|
729
|
-
* hyphen for the first or last character. Use periods to separate subdomain names.</p>
|
|
668
|
+
* <p>The domain name for the custom domain that hosts the sign-up and sign-in pages for your application. One example might be <code>auth.example.com</code>. </p>
|
|
669
|
+
* <p>This string can include only lowercase letters, numbers, and hyphens. Don't use a hyphen for the first or last character. Use periods to separate subdomain names.</p>
|
|
730
670
|
*/
|
|
731
671
|
Domain: string | undefined;
|
|
732
672
|
/**
|
|
733
|
-
* <p>The ID of the user pool that is associated with the custom domain
|
|
734
|
-
* updating the certificate for.</p>
|
|
673
|
+
* <p>The ID of the user pool that is associated with the custom domain whose certificate you're updating.</p>
|
|
735
674
|
*/
|
|
736
675
|
UserPoolId: string | undefined;
|
|
737
676
|
/**
|
|
738
|
-
* <p>The configuration for a custom domain that hosts the sign-up and sign-in pages for
|
|
739
|
-
* your application. Use this object to specify an SSL certificate that is managed by
|
|
740
|
-
* ACM.</p>
|
|
677
|
+
* <p>The configuration for a custom domain that hosts the sign-up and sign-in pages for your application. Use this object to specify an SSL certificate that is managed by ACM.</p>
|
|
741
678
|
*/
|
|
742
679
|
CustomDomainConfig: CustomDomainConfigType | undefined;
|
|
743
680
|
}
|
|
@@ -752,8 +689,7 @@ export declare namespace UpdateUserPoolDomainRequest {
|
|
|
752
689
|
*/
|
|
753
690
|
export interface UpdateUserPoolDomainResponse {
|
|
754
691
|
/**
|
|
755
|
-
* <p>The Amazon CloudFront endpoint that Amazon Cognito set up when you added the custom
|
|
756
|
-
* domain to your user pool.</p>
|
|
692
|
+
* <p>The Amazon CloudFront endpoint that Amazon Cognito set up when you added the custom domain to your user pool.</p>
|
|
757
693
|
*/
|
|
758
694
|
CloudFrontDomain?: string;
|
|
759
695
|
}
|
|
@@ -764,8 +700,7 @@ export declare namespace UpdateUserPoolDomainResponse {
|
|
|
764
700
|
const filterSensitiveLog: (obj: UpdateUserPoolDomainResponse) => any;
|
|
765
701
|
}
|
|
766
702
|
/**
|
|
767
|
-
* <p>This exception is thrown when there is a code mismatch and the service fails to
|
|
768
|
-
* configure the software token TOTP multi-factor authentication (MFA).</p>
|
|
703
|
+
* <p>This exception is thrown when there is a code mismatch and the service fails to configure the software token TOTP multi-factor authentication (MFA).</p>
|
|
769
704
|
*/
|
|
770
705
|
export interface EnableSoftwareTokenMFAException extends __SmithyException, $MetadataBearer {
|
|
771
706
|
name: "EnableSoftwareTokenMFAException";
|
|
@@ -778,12 +713,12 @@ export interface VerifySoftwareTokenRequest {
|
|
|
778
713
|
*/
|
|
779
714
|
AccessToken?: string;
|
|
780
715
|
/**
|
|
781
|
-
* <p>The session
|
|
782
|
-
* service.</p>
|
|
716
|
+
* <p>The session that should be passed both ways in challenge-response calls to the service.</p>
|
|
783
717
|
*/
|
|
784
718
|
Session?: string;
|
|
785
719
|
/**
|
|
786
|
-
* <p>The one time password computed using the secret code returned by
|
|
720
|
+
* <p>The one- time password computed using the secret code returned by
|
|
721
|
+
* <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AssociateSoftwareToken.html">AssociateSoftwareToken</a>.</p>
|
|
787
722
|
*/
|
|
788
723
|
UserCode: string | undefined;
|
|
789
724
|
/**
|
|
@@ -807,8 +742,7 @@ export interface VerifySoftwareTokenResponse {
|
|
|
807
742
|
*/
|
|
808
743
|
Status?: VerifySoftwareTokenResponseType | string;
|
|
809
744
|
/**
|
|
810
|
-
* <p>The session
|
|
811
|
-
* service.</p>
|
|
745
|
+
* <p>The session that should be passed both ways in challenge-response calls to the service.</p>
|
|
812
746
|
*/
|
|
813
747
|
Session?: string;
|
|
814
748
|
}
|
|
@@ -823,7 +757,7 @@ export declare namespace VerifySoftwareTokenResponse {
|
|
|
823
757
|
*/
|
|
824
758
|
export interface VerifyUserAttributeRequest {
|
|
825
759
|
/**
|
|
826
|
-
* <p>
|
|
760
|
+
* <p>The access token of the request to verify user attributes.</p>
|
|
827
761
|
*/
|
|
828
762
|
AccessToken: string | undefined;
|
|
829
763
|
/**
|
|
@@ -842,8 +776,7 @@ export declare namespace VerifyUserAttributeRequest {
|
|
|
842
776
|
const filterSensitiveLog: (obj: VerifyUserAttributeRequest) => any;
|
|
843
777
|
}
|
|
844
778
|
/**
|
|
845
|
-
* <p>A container representing the response from the server from the request to verify user
|
|
846
|
-
* attributes.</p>
|
|
779
|
+
* <p>A container representing the response from the server from the request to verify user attributes.</p>
|
|
847
780
|
*/
|
|
848
781
|
export interface VerifyUserAttributeResponse {
|
|
849
782
|
}
|