# Set Up Google Sign-in

> Let users sign in to CapaOne with Sign in with Google, using a Google Workspace account, a Gmail account, or a Google account created with their work email address.

Source: https://docs.capaone.com/capaone/account-administration/manage-sign-in-methods/set-up-google-sign-in/  
Product: CapaOne — a separate CapaSystems product; do not apply this page to any other.

With **Sign in with Google**, users sign in to CapaOne with a Google account. Google handles the
password and 2-Step Verification. CapaOne then matches the account's email address to a CapaOne
user.

The user doesn't need Gmail or Google Workspace. Any Google account works, as long as its email
address is the same as the user's CapaOne email address. CapaOne asks Google only for the user's
basic sign-in information and email address (`openid` and `email`). It can't read Gmail, Drive, or
other Google data.

:::note[Before you start]
- In CapaOne, you need the **Manager** role to turn on **Allow Google login**.
- Every user needs a Google account with the same email address as their CapaOne account.
:::

## Turn on Google sign-in in CapaOne

1. Open **Users & Organization**. See
   [Accessing account administration inside CapaOne](/capaone/account-administration/accessing-account-administration-inside-capaone/).
2. Click **Edit** on the organization, and select the **Security** tab.
3. Select **Allow Google login**.
4. Click **Save Changes**, and confirm the change in the **Confirm Login Security Changes** dialog.

CapaOne now accepts Google sign-ins for the organization. Users who sign in with a CapaOne password
can keep doing so. See
[Manage Sign-in Methods](/capaone/account-administration/manage-sign-in-methods/).

## Choose the type of Google account

| Your organization's email | Google account to use | Setup in Google |
|---|---|---|
| Runs on Google Workspace | The user's Google Workspace account | Usually none. See [Allow CapaOne in Google Workspace](#allow-capaone-in-google-workspace) if your organization restricts third-party apps |
| Runs elsewhere, for example Microsoft 365 | A Google account the user creates with their work email address | Each user creates the account once. See [Create a Google account with a work email address](#create-a-google-account-with-a-work-email-address) |
| Is a Gmail address | The user's Gmail account | None |

![Diagram of the Google sign-in checks: the user signs in with Google, Google Workspace allows CapaOne, Google has verified the email address, the email matches a CapaOne user, and the organization allows Google login](/attachments/capaone/set-up-google-sign-in--sign-in-flow.png)

## Create a Google account with a work email address

If your organization doesn't use Google Workspace, each user can create a free Google account with
their existing work email address. No Gmail address is created, and no administrator is involved.

1. Go to <https://accounts.google.com/signup>, or click **Create account** on a Google sign-in page.
2. Select the option for personal use.
3. Enter your name and the other basic information.
4. On the step where Google suggests a Gmail address, click **Use your existing email**.
5. Enter your work email address, the same one as your CapaOne account, and click **Next**.
6. Enter the verification code that Google sends to your work email, and click **Next**.
7. Follow the instructions to create a password and finish the setup.

The Google account now uses your work email address. You can use it with **Sign in with Google** in
CapaOne. Google verifies the email address in step 6, which CapaOne requires.

:::caution
Don't create a Google account this way if your organization uses Google Workspace for that email
domain. Use the Google Workspace account instead. A separate Google account with the same address
becomes a conflicting account. See
[How a conflicting account is created](https://support.google.com/accounts/answer/181526).
:::

## Allow CapaOne in Google Workspace

This section only applies to Google Workspace accounts.

By default, Google Workspace lets users sign in to third-party apps that request only basic
sign-in information. CapaOne requests only that, so most organizations don't need to change
anything.

If your organization blocks unconfigured third-party apps, or has blocked CapaOne, Google shows
users an **Access blocked** message. To allow CapaOne, you need a super administrator account, or an
administrator role with the **Security settings** privilege:

1. Sign in to the [Google Admin console](https://admin.google.com).
2. Go to **Security → Access and data control → API controls**.
3. Under **App access control**, click **Manage Third-Party App Access**.
4. Click **Configure new app**, and search by OAuth client ID.
5. Enter this client ID, and then select the app for `capaone.com`:

   ```text
   273149112726-f4brjg372jl9tsvkfhgj8k59iouaf0t2.apps.googleusercontent.com
   ```

6. Select the scope: the whole organization, or the organizational units that use CapaOne.
7. Select the access level. **Limited** is enough, because CapaOne doesn't access Google services.
   You can also select **Trusted**.
8. Click **Configure** or **Finish**.

CapaOne appears under **Configured apps**. Changes usually apply within minutes but can take up to
24 hours. To limit who can sign in, configure CapaOne as blocked for the organizational units that
shouldn't use it. See
[Control which third-party & internal apps access Google Workspace data](https://support.google.com/a/answer/60757).

## Test Google sign-in

After the user has a Google account with the right email address, test with one user before you tell everyone.

1. Sign out of CapaOne.
2. On the sign-in page, click **Sign in with Google**.

   ![CapaOne sign-in page with an arrow pointing to the highlighted Sign in with Google button and the tooltip Google user must have a CapaOne account with same email](/attachments/capaone/set-up-google-sign-in--button.png)

3. On the Google page, which says **to continue to capaone.com**, choose or enter your Google
   account and complete the sign-in.

   ![Google Sign in page in dark mode with the text to continue to capaone.com, the Email or phone field and the Next button](/attachments/capaone/set-up-google-sign-in--google-sign-in-page.png)

You land on the CapaOne home page. If the browser is already signed in to Google, Google might use
that account without asking. To use another account, sign out of Google first or select
**Use another account** on the Google page.

## Troubleshoot Google sign-in

| What the user sees | Cause | Fix |
|---|---|---|
| Google shows **Access blocked** and says the administrator hasn't allowed the app | Google Workspace blocks CapaOne or all unconfigured apps | [Allow CapaOne in Google Workspace](#allow-capaone-in-google-workspace) |
| Google says the email address is already in use when you create an account | A Google account with that address already exists | Sign in with that account, or recover its password |
| CapaOne shows "Wrong username, password or login method not allowed." | **Allow Google login** is off for the organization | [Turn on Google sign-in in CapaOne](#turn-on-google-sign-in-in-capaone) |
| | No CapaOne user has the Google account's email address | Compare the Google account's primary email address with the CapaOne user's email address. An alias doesn't match |
| | The browser signed in with a different Google account | Sign out of Google, or choose the right account |
| | Google hasn't verified the email address of the account | Confirm the email address in the Google account settings |

## Related

- [Manage Sign-in Methods](/capaone/account-administration/manage-sign-in-methods/)
- [Set Up Microsoft Sign-in](/capaone/account-administration/manage-sign-in-methods/set-up-microsoft-sign-in/)
- [Create a Google Account](https://support.google.com/accounts/answer/27441)
- [Control which third-party & internal apps access Google Workspace data](https://support.google.com/a/answer/60757)
