Sample code for 30+ languages & platforms
Objective-C

Amazon Cognito - Describe User Pool

See more Amazon Cognito Examples

Returns the configuration information and metadata of the specified user pool.

Chilkat Objective-C Downloads

Objective-C
#import <CkoRest.h>
#import <CkoAuthAws.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>
#import <NSString.h>

BOOL success = NO;

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

CkoRest *rest = [[CkoRest alloc] init];

CkoAuthAws *authAws = [[CkoAuthAws alloc] init];
authAws.AccessKey = @"AWS_ACCESS_KEY";
authAws.SecretKey = @"AWS_SECRET_KEY";
//  Don't forget to change the region to your particular region. (Also make the same change in the call to Connect below.)
authAws.Region = @"us-west-2";
authAws.ServiceName = @"cognito-idp";
//  SetAuthAws causes Chilkat to automatically add the following headers: Authorization, X-Amz-Date
[rest SetAuthAws: authAws];

//  URL: https://cognito-idp.us-west-2.amazonaws.com/
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
//  Use the same region as specified above.
success = [rest Connect: @"cognito-idp.us-west-2.amazonaws.com" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@%d",@"ConnectFailReason: ",[rest.ConnectFailReason intValue]);
    NSLog(@"%@",rest.LastErrorText);
    return;
}

//  Note: The above code does not need to be repeatedly called for each REST request.
//  The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
//  reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
//  made via the Connect method.

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"UserPoolId" value: @"us-west-2_yt6WzO3SA"];

[rest AddHeader: @"Content-Type" value: @"application/x-amz-json-1.0"];
[rest AddHeader: @"X-Amz-Target" value: @"AWSCognitoIdentityProviderService.DescribeUserPool"];
[rest AddHeader: @"Accept-Encoding" value: @"identity"];

CkoStringBuilder *sbRequestBody = [[CkoStringBuilder alloc] init];
[json EmitSb: sbRequestBody];
CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
success = [rest FullRequestSb: @"POST" uriPath: @"/" requestBody: sbRequestBody responseBody: sbResponseBody];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

int respStatusCode = [rest.ResponseStatusCode intValue];
NSLog(@"%@%d",@"response status code = ",respStatusCode);
if (respStatusCode != 200) {
    NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",rest.ResponseHeader);
    NSLog(@"%@",@"Response Body:");
    NSLog(@"%@",[sbResponseBody GetAsString]);
    return;
}

CkoJsonObject *jsonResponse = [[CkoJsonObject alloc] init];
[jsonResponse LoadSb: sbResponseBody];

jsonResponse.EmitCompact = NO;
NSLog(@"%@",[jsonResponse Emit]);

//  Sample JSON response:
//  (Sample code for parsing the JSON response is shown below)

//  Use this online tool to generate parsing code from sample JSON: 
//  Generate Parsing Code from JSON

//  {
//    "UserPool": {
//      "AccountRecoverySetting": {
//        "RecoveryMechanisms": [
//          {
//            "Name": "verified_phone_number",
//            "Priority": 1
//          },
//          {
//            "Name": "verified_email",
//            "Priority": 2
//          }
//        ]
//      },
//      "AdminCreateUserConfig": {
//        "AllowAdminCreateUserOnly": false,
//        "InviteMessageTemplate": {
//          "EmailMessage": "Your username is {username} and temporary password is {####}. ",
//          "EmailSubject": "Your temporary password",
//          "SMSMessage": "Your username is {username} and temporary password is {####}. "
//        },
//        "UnusedAccountValidityDays": 7
//      },
//      "Arn": "arn:aws:cognito-idp:us-west-2:954491834127:userpool/us-west-2_yt6WzO3SA",
//      "AutoVerifiedAttributes": [
//        "email",
//        "phone_number"
//      ],
//      "CreationDate": 1.636388909817E9,
//      "EmailConfiguration": {
//        "EmailSendingAccount": "DEVELOPER",
//        "From": "admin@chilkatsoft.com",
//        "ReplyToEmailAddress": "admin@chilkatsoft.com",
//        "SourceArn": "arn:aws:ses:us-west-2:954491834127:identity/admin@chilkatsoft.com"
//      },
//      "EmailVerificationMessage": "Your verification code is {####}. ",
//      "EmailVerificationSubject": "Your verification code",
//      "EstimatedNumberOfUsers": 0,
//      "Id": "us-west-2_yt6WzO3SA",
//      "LambdaConfig": {},
//      "LastModifiedDate": 1.636388910377E9,
//      "MfaConfiguration": "ON",
//      "Name": "chilkat",
//      "Policies": {
//        "PasswordPolicy": {
//          "MinimumLength": 8,
//          "RequireLowercase": true,
//          "RequireNumbers": true,
//          "RequireSymbols": true,
//          "RequireUppercase": true,
//          "TemporaryPasswordValidityDays": 7
//        }
//      },
//      "SchemaAttributes": [
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": false,
//          "Name": "sub",
//          "Required": true,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "1"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "name",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "given_name",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "family_name",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "middle_name",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "nickname",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "preferred_username",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "profile",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "picture",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "website",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "email",
//          "Required": true,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "Boolean",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "email_verified",
//          "Required": false
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "gender",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "birthdate",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "10",
//            "MinLength": "10"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "zoneinfo",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "locale",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "phone_number",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "Boolean",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "phone_number_verified",
//          "Required": false
//        },
//        {
//          "AttributeDataType": "String",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "address",
//          "Required": false,
//          "StringAttributeConstraints": {
//            "MaxLength": "2048",
//            "MinLength": "0"
//          }
//        },
//        {
//          "AttributeDataType": "Number",
//          "DeveloperOnlyAttribute": false,
//          "Mutable": true,
//          "Name": "updated_at",
//          "NumberAttributeConstraints": {
//            "MinValue": "0"
//          },
//          "Required": false
//        }
//      ],
//      "SmsAuthenticationMessage": "Your verification code is {####}. ",
//      "SmsConfiguration": {
//        "ExternalId": "94b17737-216b-4cf7-a29e-17e990e91300",
//        "SnsCallerArn": "arn:aws:iam::954491834127:role/service-role/chilkat-SMS-Role"
//      },
//      "SmsVerificationMessage": "Your verification code is {####}. ",
//      "UserPoolTags": {
//        "sampleUserPoolTag": "test"
//      },
//      "UsernameConfiguration": {
//        "CaseSensitive": false
//      },
//      "VerificationMessageTemplate": {
//        "DefaultEmailOption": "CONFIRM_WITH_CODE",
//        "EmailMessage": "Your verification code is {####}. ",
//        "EmailSubject": "Your verification code",
//        "SmsMessage": "Your verification code is {####}. "
//      }
//    }
//  }

NSString *Name = 0;
int Priority;
NSString *strVal = 0;
NSString *AttributeDataType = 0;
BOOL DeveloperOnlyAttribute;
BOOL Mutable;
BOOL Required;
NSString *StringAttributeConstraintsMaxLength = 0;
NSString *StringAttributeConstraintsMinLength = 0;
NSString *NumberAttributeConstraintsMinValue = 0;

BOOL UserPoolAdminCreateUserConfigAllowAdminCreateUserOnly = [jsonResponse BoolOf: @"UserPool.AdminCreateUserConfig.AllowAdminCreateUserOnly"];
NSString *UserPoolAdminCreateUserConfigInviteMessageTemplateEmailMessage = [jsonResponse StringOf: @"UserPool.AdminCreateUserConfig.InviteMessageTemplate.EmailMessage"];
NSString *UserPoolAdminCreateUserConfigInviteMessageTemplateEmailSubject = [jsonResponse StringOf: @"UserPool.AdminCreateUserConfig.InviteMessageTemplate.EmailSubject"];
NSString *UserPoolAdminCreateUserConfigInviteMessageTemplateSMSMessage = [jsonResponse StringOf: @"UserPool.AdminCreateUserConfig.InviteMessageTemplate.SMSMessage"];
int UserPoolAdminCreateUserConfigUnusedAccountValidityDays = [[jsonResponse IntOf: @"UserPool.AdminCreateUserConfig.UnusedAccountValidityDays"] intValue];
NSString *UserPoolArn = [jsonResponse StringOf: @"UserPool.Arn"];
NSString *UserPoolCreationDate = [jsonResponse StringOf: @"UserPool.CreationDate"];
NSString *UserPoolEmailConfigurationEmailSendingAccount = [jsonResponse StringOf: @"UserPool.EmailConfiguration.EmailSendingAccount"];
NSString *UserPoolEmailConfigurationFrom = [jsonResponse StringOf: @"UserPool.EmailConfiguration.From"];
NSString *UserPoolEmailConfigurationReplyToEmailAddress = [jsonResponse StringOf: @"UserPool.EmailConfiguration.ReplyToEmailAddress"];
NSString *UserPoolEmailConfigurationSourceArn = [jsonResponse StringOf: @"UserPool.EmailConfiguration.SourceArn"];
NSString *UserPoolEmailVerificationMessage = [jsonResponse StringOf: @"UserPool.EmailVerificationMessage"];
NSString *UserPoolEmailVerificationSubject = [jsonResponse StringOf: @"UserPool.EmailVerificationSubject"];
int UserPoolEstimatedNumberOfUsers = [[jsonResponse IntOf: @"UserPool.EstimatedNumberOfUsers"] intValue];
NSString *UserPoolId = [jsonResponse StringOf: @"UserPool.Id"];
NSString *UserPoolLastModifiedDate = [jsonResponse StringOf: @"UserPool.LastModifiedDate"];
NSString *UserPoolMfaConfiguration = [jsonResponse StringOf: @"UserPool.MfaConfiguration"];
NSString *UserPoolName = [jsonResponse StringOf: @"UserPool.Name"];
int UserPoolPoliciesPasswordPolicyMinimumLength = [[jsonResponse IntOf: @"UserPool.Policies.PasswordPolicy.MinimumLength"] intValue];
BOOL UserPoolPoliciesPasswordPolicyRequireLowercase = [jsonResponse BoolOf: @"UserPool.Policies.PasswordPolicy.RequireLowercase"];
BOOL UserPoolPoliciesPasswordPolicyRequireNumbers = [jsonResponse BoolOf: @"UserPool.Policies.PasswordPolicy.RequireNumbers"];
BOOL UserPoolPoliciesPasswordPolicyRequireSymbols = [jsonResponse BoolOf: @"UserPool.Policies.PasswordPolicy.RequireSymbols"];
BOOL UserPoolPoliciesPasswordPolicyRequireUppercase = [jsonResponse BoolOf: @"UserPool.Policies.PasswordPolicy.RequireUppercase"];
int UserPoolPoliciesPasswordPolicyTemporaryPasswordValidityDays = [[jsonResponse IntOf: @"UserPool.Policies.PasswordPolicy.TemporaryPasswordValidityDays"] intValue];
NSString *UserPoolSmsAuthenticationMessage = [jsonResponse StringOf: @"UserPool.SmsAuthenticationMessage"];
NSString *UserPoolSmsConfigurationExternalId = [jsonResponse StringOf: @"UserPool.SmsConfiguration.ExternalId"];
NSString *UserPoolSmsConfigurationSnsCallerArn = [jsonResponse StringOf: @"UserPool.SmsConfiguration.SnsCallerArn"];
NSString *UserPoolSmsVerificationMessage = [jsonResponse StringOf: @"UserPool.SmsVerificationMessage"];
NSString *UserPoolUserPoolTagsSampleUserPoolTag = [jsonResponse StringOf: @"UserPool.UserPoolTags.sampleUserPoolTag"];
BOOL UserPoolUsernameConfigurationCaseSensitive = [jsonResponse BoolOf: @"UserPool.UsernameConfiguration.CaseSensitive"];
NSString *UserPoolVerificationMessageTemplateDefaultEmailOption = [jsonResponse StringOf: @"UserPool.VerificationMessageTemplate.DefaultEmailOption"];
NSString *UserPoolVerificationMessageTemplateEmailMessage = [jsonResponse StringOf: @"UserPool.VerificationMessageTemplate.EmailMessage"];
NSString *UserPoolVerificationMessageTemplateEmailSubject = [jsonResponse StringOf: @"UserPool.VerificationMessageTemplate.EmailSubject"];
NSString *UserPoolVerificationMessageTemplateSmsMessage = [jsonResponse StringOf: @"UserPool.VerificationMessageTemplate.SmsMessage"];

int i = 0;
int count_i = [[jsonResponse SizeOfArray: @"UserPool.AccountRecoverySetting.RecoveryMechanisms"] intValue];
while (i < count_i) {
    jsonResponse.I = [NSNumber numberWithInt: i];
    Name = [jsonResponse StringOf: @"UserPool.AccountRecoverySetting.RecoveryMechanisms[i].Name"];
    Priority = [[jsonResponse IntOf: @"UserPool.AccountRecoverySetting.RecoveryMechanisms[i].Priority"] intValue];
    i = i + 1;
}

i = 0;
count_i = [[jsonResponse SizeOfArray: @"UserPool.AutoVerifiedAttributes"] intValue];
while (i < count_i) {
    jsonResponse.I = [NSNumber numberWithInt: i];
    strVal = [jsonResponse StringOf: @"UserPool.AutoVerifiedAttributes[i]"];
    i = i + 1;
}

i = 0;
count_i = [[jsonResponse SizeOfArray: @"UserPool.SchemaAttributes"] intValue];
while (i < count_i) {
    jsonResponse.I = [NSNumber numberWithInt: i];
    AttributeDataType = [jsonResponse StringOf: @"UserPool.SchemaAttributes[i].AttributeDataType"];
    DeveloperOnlyAttribute = [jsonResponse BoolOf: @"UserPool.SchemaAttributes[i].DeveloperOnlyAttribute"];
    Mutable = [jsonResponse BoolOf: @"UserPool.SchemaAttributes[i].Mutable"];
    Name = [jsonResponse StringOf: @"UserPool.SchemaAttributes[i].Name"];
    Required = [jsonResponse BoolOf: @"UserPool.SchemaAttributes[i].Required"];
    StringAttributeConstraintsMaxLength = [jsonResponse StringOf: @"UserPool.SchemaAttributes[i].StringAttributeConstraints.MaxLength"];
    StringAttributeConstraintsMinLength = [jsonResponse StringOf: @"UserPool.SchemaAttributes[i].StringAttributeConstraints.MinLength"];
    NumberAttributeConstraintsMinValue = [jsonResponse StringOf: @"UserPool.SchemaAttributes[i].NumberAttributeConstraints.MinValue"];
    i = i + 1;
}