Cloud-based recovery

This guide explains how to set up cloud storage accounts for user-managed recovery of embedded wallets.

Start with a walkthrough of the user experience of password-based recovery, and continue to concrete configuration details below.

User experience

Setting up (i.e.) Google Drive for user-managed recovery

Setup

When a user chooses Google Drive or iCloud as their preferred option for user-managed recovery, the Privy modal will prompt the user to authorize access to their Google / iCloud account. Upon success, Privy will store a recovery secret in the user's Google Drive (for Google), or securely in your CloudKit database (for iCloud).

Recovery

Once a user has set up cloud-based recovery, when they attempt to use the wallet on a new device or browser, Privy will automatically prompt the user to authorize access to their Google / iCloud account.

Once the user successfully authorizes with the provider, they can use the wallet on that device, and will not be prompted to authorize on that device again.

Integration

Configuration

To configure Google Drive and/or iCloud as options for user-managed recovery, follow the guide here to set up the correct settings in the Privy Dashboard.

Prompting users to set up cloud-based recovery

To require that users set up cloud-based recovery when they first create their wallet, visit the Embedded wallets page of the Privy Dashboard and navigate to the Recovery methods tab. Toggle the Require recovery method on wallet creation option on.

Your app can either prompt users to set a password when they first create their wallet, or at a later point in time.

When this setting is on, users will be automatically be prompted to set up user-managed recovery when they create their wallet. Note that:

• When setting up user-managed recovery, users can choose any of the recovery methods you have enabled in the Dashboard. This will include Google Drive, iCloud, and passwords.
• If the user does not successfully set up cloud-based recovery (or passwords) when creating their wallet, a wallet will not be created for them.

Setting cloud recovery at a later point

See Recovery upgrade.