Page updated Nov 14, 2023

Enable guest access

Amplify iOS v1 is now in Maintenance Mode until May 31st, 2024. This means that we will continue to include updates to ensure compatibility with backend services and security. No new features will be introduced in v1.

Please use the latest version (v2) of Amplify Library for Swift to get started.

If you are currently using v1, follow these instructions to upgrade to v2.

Amplify libraries should be used for all new cloud connected applications. If you are currently using the AWS Mobile SDK for iOS, you can access the documentation here.

The AWS Cognito Auth Plugin can be configured to automatically obtain guest credentials once the device is online so that you are able to use other categories "anonymously" without the need to sign in. You will not be able to perform user specific methods while in this state such as updating attributes, changing your password, or getting the current user. However, you can obtain the unique Identity ID which is assigned to the device through the fetchAuthSession method described here.

Follow these steps to enable guest access on your Auth category:

1amplify update auth
2What do you want to do? Walkthrough all the auth configurations
3Select the authentication/authorization services that you want to use: [choose whatever you initially selected - default is User Sign-Up, Sign-In, connected with AWS IAM controls]
4Allow unauthenticated logins? (Provides scoped down permissions that you can control via AWS IAM)
5❯ Yes
6 No
7 I want to learn more.
9 [proceed through the rest of the steps choosing the values you want - default is usually "No"]

To push your changes to the cloud, execute the command:

1amplify push

That's it! Now as long as you are online, you will automatically gain guest credentials (which are then cached for offline use as well).