Enable guest access

Amplify iOS v1 is deprecated as of June 1st, 2024. No new features or bug fixes will be added. Dependencies may become outdated and potentially introduce compatibility issues.

Please use the latest version (v2) of Amplify Library for Swift to get started. Refer to the upgrade guide for instructions on upgrading your application to the latest version.

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:

amplify update auth
What do you want to do?
❯ Walkthrough all the auth configurations
Select 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]
Allow unauthenticated logins? (Provides scoped down permissions that you can control via AWS IAM)
 I want to learn more.
 [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:

amplify 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).