Skip to main content
With Microsoft SSO, your users log in to Mooncamp with their Microsoft work account (Microsoft Entra ID, formerly Azure AD). It is available on all plans. For a general overview of SSO in Mooncamp, see SSO Setup.

Before you start

  • You need write access to the workspace settings in Mooncamp.
  • Every user who should log in must exist in your Mooncamp workspace with exactly the same email address they use to sign in to Microsoft, their user principal name (UPN), for example jane.doe@company.com. If the addresses differ, the login fails.
  • Many organizations only allow apps that an admin has approved. In that case you also need someone with an admin role in Microsoft Entra ID (for example Cloud Application Administrator, Application Administrator or Global Administrator). You find out in step 3 whether this applies to you.

Setup

1

Allow login via Microsoft in Mooncamp

Go to Settings > Identity and provisioning and switch on Allow login via Microsoft under Access.
2

Add your users to Mooncamp

Add everyone who should log in under Settings > Members (see Managing members).
The email address in Mooncamp must be exactly the user’s UPN in Microsoft Entra ID, not an alias or a different mail address. Your Entra admin can look it up in the user’s profile under User principal name.
3

Log in once with Microsoft

Open the Mooncamp login page, click Log in via Microsoft and sign in with your Microsoft account.
Mooncamp login page with the Log in via Microsoft button highlighted
  • You are logged in to Mooncamp: your organization allows users to approve apps themselves. You are done, and all other users can log in the same way.
  • Microsoft shows “Need admin approval” or “Approval required”: your organization requires an admin to approve Mooncamp first. Continue with the next step.
4

Get admin approval in Microsoft Entra ID

An Entra ID admin approves Mooncamp once for the whole organization. There are two ways to do this, described in the next section.
5

Log in

Right after the approval, users can log in with Log in via Microsoft. Nobody needs to approve anything again.

Getting admin approval

Option A: the admin logs in to Mooncamp

This is the quickest way if your Entra ID admin also has a Mooncamp account.
  1. The admin opens the Mooncamp login page and clicks Log in via Microsoft.
  2. Microsoft shows the permissions Mooncamp requests. The admin selects Consent on behalf of your organization and then Accept.

Option B: the user sends a request, the admin approves it

If your organization has turned on the admin consent workflow, the “Approval required” screen lets users send a request:
  1. The user enters a short reason (for example “Login to Mooncamp, our goal management tool”) and selects Request approval.
  2. The admin gets an email, signs in to the Microsoft Entra admin center and goes to Entra ID > Enterprise apps > Admin consent requests (under Activity), tab My Pending.
  3. The admin selects the request for the app Mooncamp Login, checks the permissions with Review permissions and consent and grants consent.
If the workflow is not turned on, users only see “Need admin approval” and can’t send a request. In that case, ask your admin to use option A.
Once Mooncamp has been approved, the admin can find it in the Entra admin center under Entra ID > Enterprise apps > All applications (search for “Mooncamp Login”). Under Security > Permissions, Grant admin consent approves it again for the whole organization, for example if permissions were removed.

What Mooncamp asks for

Mooncamp only requests the Microsoft Graph permission User.Read (“Sign in and read user profile”). Mooncamp uses it to read the name and email address of the person logging in. Mooncamp can’t access emails, files or other users through this login.

Good to know

  • SSO doesn’t add users. Approving Mooncamp in Entra ID doesn’t create any users in Mooncamp. Only people added to your Mooncamp workspace can log in. To create, update and remove users automatically from Entra ID, use user provisioning via SCIM (Enterprise).
  • Restrict who can use the app (optional). By default, after approval every user in your Microsoft organization may sign in to the app; Mooncamp still only lets in people who are members of your workspace. If you want to limit this in Entra ID as well, set Assignment required on the app Mooncamp Login and assign users or groups.
  • Only allow Microsoft. If everyone logs in with Microsoft, switch off Allow login via password and Allow login via Google under Settings > Identity and provisioning.

Troubleshooting

Check that the user exists under Settings > Members and that the email address there is exactly the same as their Microsoft sign-in address (user principal name). Aliases don’t count.
This can happen after a rename or a tenant migration (for example sign-in j.doe@company.com, email jane.doe@company.com). Add the user in Mooncamp with their sign-in address. If that isn’t possible, contact our support: if both addresses use the same domain, we can turn on matching by the email address for your workspace.
Check that consent was granted for the whole organization (option A with Consent on behalf of your organization, or option B). An approval for a single user doesn’t apply to the others.
At least one login method must stay switched on, and you can’t switch off the method you used for your current session. Log in with Microsoft first, then switch off login via password.