diff --git a/cloud/assets/login-oauth-check-email-page.png b/cloud/assets/login-oauth-check-email-page.png new file mode 100644 index 0000000000..e46b0b8199 Binary files /dev/null and b/cloud/assets/login-oauth-check-email-page.png differ diff --git a/cloud/assets/login-page-oauth-buttons.png b/cloud/assets/login-page-oauth-buttons.png new file mode 100644 index 0000000000..dabd04bf1a Binary files /dev/null and b/cloud/assets/login-page-oauth-buttons.png differ diff --git a/cloud/cloud-overview.mdx b/cloud/cloud-overview.mdx index ef144f0104..fcdd164753 100644 --- a/cloud/cloud-overview.mdx +++ b/cloud/cloud-overview.mdx @@ -34,6 +34,8 @@ like adding or removing nodes, and run recurring tasks like backing up your data * [Your Account](../cloud/cloud-overview.mdx#your-account) - [Register](../cloud/cloud-overview.mdx#register-your-account) - [Login](../cloud/cloud-overview.mdx#login-to-your-account) + - [Login with a magic link](../cloud/cloud-overview.mdx#login-with-a-magic-link) + - [Login with GitHub or Google](../cloud/cloud-overview.mdx#login-with-github-or-google) * [RavenDB on the Cloud](../cloud/cloud-overview.mdx#ravendb-on-the-cloud) * [Instances, Provisioning and RavenDB Products](../cloud/cloud-overview.mdx#instances-provisioning-and-ravendb-products) * [RavenDB Tiers: Free, Development and Production](../cloud/cloud-overview.mdx#ravendb-tiers) @@ -68,6 +70,14 @@ as soon as you finish registering, so you can immediately start creating and han To create a new account, enter [https://cloud.ravendb.net/user/register](https://cloud.ravendb.net/user/register) and allow the wizard to walk you through the 5 simple stages of the registration procedure: + +You can also start registration by clicking **Login via GitHub** or **Login via Google** on the +[login page](../cloud/cloud-overview.mdx#login-to-your-account). If no Cloud account exists yet for +the email reported by the provider, a registration link is sent to that address and the registration +form opens with the email already filled in. +See [Login with GitHub or Google](../cloud/cloud-overview.mdx#login-with-github-or-google). + + 1. **Email** 2. **Account information** 3. **Billing information** @@ -118,7 +128,10 @@ Click the **Skip Billing Information** button if you prefer to evaluate the clou ## Login To Your Account To access your account, click [https://cloud.ravendb.net/user/login](https://cloud.ravendb.net/user/login). -#### Login + +You can sign in either with a **magic link** sent to your email, or by using your +**GitHub** or **Google** account. +#### Login with a magic link !["Figure 7 - Login page"](./assets/login-page-email.png) - Enter the same email address you provided during registration, confirm you're not a robot, and @@ -139,7 +152,35 @@ To access your account, click [https://cloud.ravendb.net/user/login](https://clo We advise you to enable 2FA. Setup is described [here](../cloud/cloud-security.mdx#enable-mfa). +#### Login with GitHub or Google + +In addition to the magic link, you can sign in using your **GitHub** or **Google** account. +The login page shows **Login via GitHub** and **Login via Google** buttons below the magic-link form. + +!["Figure 8 - Login page with GitHub and Google buttons"](./assets/login-page-oauth-buttons.png) + +- Click **Login via GitHub** or **Login via Google**. +- Authorize RavenDB Cloud at the chosen provider. +- You are returned to RavenDB Cloud and signed in to the account whose email address matches the one + reported by the provider. + + +Your RavenDB Cloud account is identified by **email address**. GitHub and Google sign in only +succeed when the email reported by the provider matches the email of an existing Cloud account. + + + +If [2FA](../cloud/cloud-security.mdx#enable-mfa) is enabled on your account, you will be prompted +for the second factor after authorizing at GitHub or Google, just like with the magic link. + + +**No Cloud account for the email** + +If no RavenDB Cloud account exists for the email returned by GitHub or Google, you are taken to a +**Check your inbox** page and an email with a sign-in link is sent to that address. Following the +link opens the registration form with the email pre-filled, so you can finish creating the account. +!["Figure 9 - Check your inbox page"](./assets/login-oauth-check-email-page.png) ## RavenDB on the Cloud