Drop-in auth

The AWS SDK for iOS entered Maintenance Phase as of August 1, 2025.

During this maintenance period:

Critical bug fixes and security patches will continue to be provided
No new features or enhancements will be added
Existing functionality will remain supported

We recommend that you start using AWS Amplify for iOS, our modern feature-rich library designed specifically for building cloud-connected apps powered by AWS. You can refer to the AWS SDK for iOS migration guide to help you transition to AWS Amplify for Swift.

This version is scheduled to reach End of Support on August 1, 2026. After this date, no further updates of any kind will be provided. See maintenance policy for more information about the Amplify Client Library lifecycle.

The AWSMobileClient client supports a "drop-in" UI component that allows you to easily add the full capabilities for authentication to your application.

AWSMobileClient.default().showSignIn(
    navigationController: self.navigationController!, { (signInState, error) in
        if let signInState = signInState {
            print("Sign in flow completed: \(signInState)")
        } else if let error = error {
            print("error logging in: \(error.localizedDescription)")

Note: The drop-in UI requires the use of a navigation controller. Please make sure your app has an active navigation controller which is passed in via the navigationController parameter.

Customization

You can change the following properties of the drop-in UI with the AWSMobileClient:

Logo: Any image file of png or jpg
Background Color: Any iOS UIColor

AWSMobileClient.default()
    .showSignIn(
        navigationController: self.navigationController!,
        signInUIOptions: SignInUIOptions(
            // dismiss the sign-in process
            canCancel: false,
            logoImage: UIImage(
                named: "MyCustomLogo"
            backgroundColor: UIColor.black
    ) { (result, err) in
        //handle results and errors