# Sign-in codes for Google and Microsoft accounts

[Read this guide on KeySigner](https://keysigner.io/integrations/guides/set-up-workspace-account-sign-in-codes/)

Test a KeySigner authenticator code with Google Workspace, Google Cloud, Microsoft Entra ID or Azure. Use a test account whose policy allows codes, then check that the code works in the app you plan to use.

## Before you start

**KeySigner on iPhone or Mac with Sign-in codes**

- Use a test Workspace user whose organizational unit or group allows authenticator codes. Check that an independent verification or recovery method is available.
- Use a non-admin account that signs in directly with Google and can view a sandbox project. Keep the existing verification method available.
- Use a tenant test user included in Third-party software OATH tokens. Check the authentication strength for the intended app and keep an independent method available.
- Use a tenant test user with read access to a sandbox resource and a policy that permits software OATH codes for the portal. Keep independent recovery available.

## Data and access

- **Shared or checked**. Google or Microsoft checks a short code from the enrollment for the selected account. KeySigner holds its own copy of the enrollment.
- **Check separately**. Other enrolled authenticators may still work. Workspace, directory or cloud roles and existing service sessions require separate checks.

## 1. Open the setup QR code

Use a test account with an existing recovery method and keep its working session open. Check the exact email address and domain or directory before you open the QR code. Use the policy already in place.

**Check.** The selected test account shows an authenticator QR code. A policy requiring a security key, passkey or another phishing-resistant method may exclude codes for this sign-in.

### Find the right account settings

- **[Google Workspace or Google Cloud](https://support.google.com/accounts/answer/1066447?hl=en)**. For an account that signs in directly with Google, open Google Account security settings, select 2-Step Verification, then set up Authenticator. In Google Workspace, ask your administrator to confirm the method is allowed for your group or organizational unit. If a different identity provider handles the Google Cloud sign-in, enroll with that provider instead.
- **[Microsoft Entra ID or Azure](https://learn.microsoft.com/en-us/entra/identity/authentication/how-to-authentication-methods-manage)**. Ask your administrator to confirm that Third-party software OATH tokens applies to your test user. In Security info for the correct directory, choose Add sign-in method, select the authenticator app, and choose the option to use a different authenticator app. Continue until the QR code appears.

## 2. Add the account in KeySigner

Open Accounts, choose Add (+), then Sign-in codes and backup. Unlock Sign-in codes and choose Add account. Scan the setup QR code or use the image picker on Mac. Review the issuer and account. Keep the QR code and setup key private.

![KeySigner for Mac, with controls to scan a QR code, pick an image or enter a setup link.](https://keysigner.io/integrations/guides/set-up-a-time-based-sign-in-code/keysigner-add-account.png)

The KeySigner Mac setup screen. Use the QR code from your provider’s test account.

**Check.** The saved KeySigner entry shows the expected issuer and account.

## 3. Verify the enrollment code

In KeySigner, choose Show code and complete the required approvals. Enter the current code in the provider’s setup form. Confirm the method is saved. Keep the existing security key, passkey or other independent recovery method available.

**Check.** The provider accepts the code and lists the authenticator in your account’s verification methods.

## 4. Try a fresh sign-in to the target app

Open a private browser window and use the same account. For Google Cloud or Azure, open the intended console and select your test project or directory. If another method is offered first, choose the authenticator code option when available. Approve a fresh code in KeySigner and enter it. An existing session or a different verification method leaves this test incomplete.

**Check.** The intended app opens after accepting a new code for the same account. For a cloud console, also confirm the project or directory. In Microsoft Entra, an administrator can check Authentication Details for an OATH verification code on this sign-in.

## Check your result

Record the account, policy, app and sign-in where the code was accepted. The provider receives the code, and KeySigner can require approvals to show its copy. A separate authenticator can still verify your sign-in if the provider allows it. Anyone with a copy of the same setup key can generate the same codes.

### What we tested

**Tested on November 18, 2026.** In a local vault test, KeySigner imported a disposable account. A separate test verifier accepted the fresh code and rejected codes that were invalid, reused, expired or submitted for the wrong account. The Google and Microsoft steps follow provider documentation and need verification in your own test account.

[How to verify your setup](https://keysigner.io/integrations/verify-a-setup/)

## If you get stuck

### The code option is missing or the code is rejected

Check the account, device time and app policy. If the timer is near the end, wait for the next code. Google says an enrolled authenticator can take up to seven days to appear as a sign-in option. If the app requires a phishing-resistant method, use an allowed method and keep your recovery path available.

## Tools in this guide

- [Google Workspace](https://keysigner.io/integrations/google-workspace/)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#google-workspace)
- [Google Cloud](https://keysigner.io/integrations/google-cloud/)
  - [Review and change access to a cloud project](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#google-cloud)
- [Microsoft Entra ID](https://keysigner.io/integrations/microsoft-entra-id/)
  - [Review how to enable passkeys for a pilot group](https://learn.microsoft.com/en-us/entra/identity/authentication/how-to-authentication-passkeys-fido2)
  - [Review third-party software OATH settings](https://learn.microsoft.com/en-us/entra/identity/authentication/how-to-authentication-methods-manage)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#microsoft-entra-id)
- [Microsoft Azure](https://keysigner.io/integrations/microsoft-azure/)
  - [Set role assignments in the Azure portal](https://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal)
  - [Setup requirements](https://keysigner.io/integrations/setup-requirements/#microsoft-azure)

## Setup instructions

- [Check Google Workspace 2-Step Verification policy](https://knowledge.workspace.google.com/admin/security/deploy-2-step-verification)
- [Check 2-Step Verification for Google Cloud](https://docs.cloud.google.com/docs/authentication/mfa-requirement)
- [Check Azure portal MFA requirements](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-mandatory-multifactor-authentication)
- [Check when Microsoft Entra allows software OATH codes](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-authentication-strengths)
- [Find OATH verification in Microsoft Entra sign-in logs](https://learn.microsoft.com/en-us/entra/identity/authentication/howto-mfa-reporting)
- [Compare authenticator app policies](https://keysigner.io/integrations/guides/check-authenticator-app-policies/)
- [Verify a one-time code in a local Keycloak realm](https://keysigner.io/integrations/guides/set-up-a-keycloak-one-time-code/#what-we-tested)
- [Test the same account in Azure DevOps](https://keysigner.io/integrations/guides/test-an-azure-devops-sign-in-code/)

[More guides for this task](https://keysigner.io/integrations/tasks/set-up-sign-in-codes/)
