Skip to main content

Microsoft 365 SSO

Microsoft 365 SSO allows your team to log into Readybuild using their existing Microsoft 365 credentials. This eliminates the need for separate passwords and simplifies user management.

Benefits​

  • Simplified login - Users sign in with their existing Microsoft credentials
  • Centralized management - Control access through Azure AD
  • Enhanced security - Leverage Microsoft's authentication infrastructure
  • Reduced password fatigue - One less password to remember

Setting Up SSO​

Step 1: Navigate to Integration Settings​

  1. Go to Settings > Integrations in Readybuild
  2. Find Microsoft 365 in the list
  3. Click Configure

Step 2: Connect Microsoft 365 SSO​

  1. Find the Microsoft 365 SSO card
  2. Click Connect
  3. Sign in with your Microsoft administrator account
  4. Review the permissions requested
  5. Click Accept to grant consent

Step 3: Configure Domain Restriction (Optional)​

To restrict which Microsoft accounts can log in:

  1. After connecting, expand the SSO configuration
  2. Enter your company's email domain in the Domain Restriction field (e.g., yourcompany.com)
  3. Click Save

This ensures only users with email addresses from your domain can access Readybuild via SSO.

Connection Status​

StatusMeaning
Connected (green)SSO is fully configured and working
Partial (yellow)Connected but needs domain restriction configured
Disconnected (gray)SSO not enabled

How Users Log In​

Once SSO is enabled, users can:

  1. Go to the Readybuild login page
  2. Click Sign in with Microsoft
  3. Enter their Microsoft 365 credentials
  4. Access Readybuild without a separate password
First-Time Login

Users must have an existing Readybuild account with a matching email address. SSO authenticates existing users—it does not create new accounts.

Disconnecting SSO​

  1. Go to Settings > Integrations > Microsoft 365
  2. Click Disconnect on the SSO card
  3. Confirm the action

Note: Users will need to use their Readybuild passwords after disconnecting SSO. If they don't remember their password, they can use the "Forgot Password" feature.

Troubleshooting​

"Unable to sign in" Error​

Causes:

  • Microsoft account email doesn't match domain restriction
  • SSO not properly connected
  • Browser caching issues

Solutions:

  1. Verify your Microsoft account email matches the domain restriction
  2. Check that SSO is properly connected in Readybuild settings
  3. Clear browser cookies and try again
  4. Contact your IT administrator to verify Azure AD configuration

User Has No Readybuild Account​

SSO only works for existing users. If a Microsoft user tries to log in but has no Readybuild account:

  1. An administrator must first create the user in Readybuild
  2. The user's email in Readybuild must match their Microsoft email
  3. After the account exists, SSO login will work

If the connection fails during setup:

  1. Ensure you have Global Administrator or Application Administrator permissions
  2. Check that your organization allows third-party app consent
  3. Contact your Azure AD administrator if consent is blocked by policy

Security Considerations​

  • Domain restriction is recommended - Without it, any Microsoft account could potentially access your Readybuild
  • Azure AD policies apply - Conditional access, MFA, and other Azure AD security policies affect SSO login
  • Token revocation - Disconnecting SSO immediately invalidates all SSO sessions