Skip to content

Set Up Microsoft Sign-in

With Sign in with Microsoft, users sign in to CapaOne with their Microsoft work or school account, or with a personal Microsoft account. Microsoft handles the password, multifactor authentication, and any Conditional Access policies in your tenant. CapaOne then matches the account’s email address to a CapaOne user.

CapaOne uses its own multitenant application for sign-in, so you don’t register an application in your tenant. This is separate from Integrate CapaOne with Entra ID, which syncs users and groups.

  1. Open Users & Organization. See Accessing account administration inside CapaOne.
  2. Click Edit on the organization, and select the Security tab.
  3. Select Allow Microsoft login.
  4. Click Save Changes, and confirm the change in the Confirm Login Security Changes dialog.

CapaOne now accepts Microsoft sign-ins for the organization. Users who sign in with a CapaOne password can keep doing so. See Manage Sign-in Methods.

CapaOne accepts a Microsoft sign-in only when all of these are true:

  • The email address matches a CapaOne user. CapaOne reads the email address from the Microsoft account. For a work or school account, that’s the Email field under Contact Information on the user in Entra ID. CapaOne doesn’t use the user principal name. If Email is empty, the sign-in fails, even when the user principal name matches the CapaOne user.

    Contact Information section of a user in Microsoft Entra ID with the Email field highlighted and set to user@contoso.com

  • The email domain is verified in the user’s tenant. In the Microsoft Entra admin center, the domain must show Verified under Entra ID → Domain names. CapaOne rejects email addresses that the signing tenant doesn’t own. This blocks other tenants from signing in as your users.

  • The user signs in with their own account, not a guest account. A guest (B2B) account in another organization’s tenant uses a domain that tenant doesn’t own, so CapaOne rejects it.

  • The tenant lets the user use CapaOne. This depends on the consent and assignment settings in the next sections.

Personal Microsoft accounts, such as Outlook.com accounts, also meet the domain requirement.

Diagram of the Microsoft sign-in checks: the user signs in with Microsoft, the tenant allows CapaOne, Microsoft confirms the tenant owns the email domain, the email matches a CapaOne user, and the organization allows Microsoft login

CapaOne needs admin consent once for your tenant. One of its permissions can only be granted by an administrator, so users can’t consent for themselves, whatever your user consent settings are.

The usual way is to let an administrator sign in to CapaOne with Microsoft first. If that doesn’t work, use the admin consent link.

The first time someone in your tenant clicks Sign in with Microsoft on the CapaOne sign-in page, Microsoft shows a different page depending on the account:

  • An administrator sees Permissions requested. The administrator reviews the permissions and selects Accept. This grants consent for the whole organization.
  • A user without an admin role sees Need admin approval, and sign-in stops. The user can select Have an admin account? Sign in with that account to let an administrator take over.

Microsoft Need admin approval page for CapaOne, marked unverified, with the links Have an admin account? Sign in with that account and Return to the application without granting consent

The administrator needs one of the Entra roles listed in Before you start. After the consent, every user in your tenant can sign in without seeing either page.

Use this link to grant consent before anyone signs in, or when the first sign-in doesn’t show the Permissions requested page.

  1. In a browser, open this URL. Replace <tenant> with your tenant ID or a verified domain, for example contoso.com:

    https://login.microsoftonline.com/<tenant>/adminconsent?client_id=3bd688d1-ef6f-48c3-9af8-2287acd5dffb
  2. Sign in with an account that has one of the Entra roles listed in Before you start.

  3. Review the Permissions requested dialog. It shows CapaOne as unverified, because CapaOne isn’t publisher-verified. To see the description of a permission, expand it.

    Microsoft Permissions requested dialog for CapaOne, marked unverified, with the three requested permissions and the Cancel and Accept buttons

  4. Select Accept.

Microsoft then sends you back to CapaOne. The CapaOne sign-in page might show “Wrong username, password or login method not allowed.” This doesn’t mean that the consent failed.

  1. In the Microsoft Entra admin center, go to Entra ID → Enterprise apps → All applications.
  2. Search for the application ID 3bd688d1-ef6f-48c3-9af8-2287acd5dffb, and open CapaOne.
  3. Select Security → Permissions.

The permissions are listed under Admin consent. If CapaOne is listed but has no admin consent, select Grant admin consent for <your organization> on this page.

Permission Type Shown in the consent dialog as What Microsoft says it allows
openid Delegated Sign in and read user profile Users sign in to the app.
offline_access Delegated Maintain access to data you have given it access to The app keeps access to the data you gave it access to when the user isn’t using the app. It gives no additional permissions.
Organization.Read.All Application Read organization information The app reads the organization and related resources, such as subscribed SKUs and tenant branding, without a signed-in user.

If no administrator can sign in first, turn on the admin consent workflow. Users who see Need admin approval can then send a request to an approver instead of being stopped.

  1. Sign in to the Microsoft Entra admin center as a Global Administrator.
  2. Go to Entra ID → Enterprise apps → Consent and permissions → Admin consent settings.
  3. Set Users can request admin consent to apps they are unable to consent to to Yes.
  4. Select the reviewers, and then select Save.

Reviewers see the request under Enterprise apps → Admin consent requests. See Configure the admin consent workflow.

After CapaOne appears under Enterprise apps, you can control access from Entra ID:

  • Assign users: open the app, select Properties, set Assignment required? to Yes, and select Save. Then add the allowed users or groups under Users and groups. Users who aren’t assigned can’t sign in to CapaOne with Microsoft.
  • Require MFA or a compliant device: create a Conditional Access policy that targets the app.

After you allow CapaOne in your Entra tenant, test with one user before you tell everyone.

  1. Sign out of CapaOne.

  2. On the sign-in page, click Sign in with Microsoft.

    CapaOne sign-in page with an arrow pointing to the highlighted Sign in with Microsoft button and the tooltip Microsoft user must have a CapaOne account with same email

  3. On the Microsoft page, select or enter your Microsoft account and complete the sign-in.

    Microsoft Sign in page in dark mode with the Email, phone, or Skype field and the Next button

You land on the CapaOne home page. Microsoft always shows the account picker, so users with several accounts can choose the right one.

What the user sees Cause Fix
Microsoft shows Need admin approval (AADSTS90094 or AADSTS65001) No administrator has granted consent for your tenant yet Let an administrator sign in first, or use the admin consent link
Microsoft says the user isn’t assigned to the application (AADSTS50105) Assignment required? is Yes and the user isn’t assigned Add the user or a group under Users and groups
Microsoft blocks the sign-in (AADSTS53003) A Conditional Access policy blocks access Check the user’s sign-in logs in Entra ID
CapaOne shows “Wrong username, password or login method not allowed.” Allow Microsoft login is off for the organization Turn on Microsoft sign-in in CapaOne
The Email field of the user in Entra ID is empty Enter the user’s email address under Contact Information → Email in Entra ID
No CapaOne user has the account’s email address Check the user’s Email field in Entra ID, and the email address of the CapaOne user
The email domain isn’t verified in the tenant, or the user signed in with a guest account Verify the domain under Domain names, or sign in with the account from the user’s own tenant