How to Log In with Your Microsoft Account (SSO)
What it is
RAPTIX supports signing in with your existing Microsoft work or school account — the same account you use for Outlook, Teams, and other Microsoft 365 services. When you click Continue with Microsoft, the platform redirects you to Microsoft's own sign-in page, you authenticate there, and Microsoft hands you back to RAPTIX already signed in. This is called Single Sign-On (SSO).
If your organization has SSO enabled and your Microsoft email matches a RAPTIX account (or your administrator has turned on automatic account creation), the whole process takes only a few seconds and requires no separate RAPTIX password.
Why it's useful / Key benefits
- No extra password to remember — your Microsoft credentials are the only ones you need.
- One-click sign-in — tap Continue with Microsoft, authenticate once with Microsoft if you are not already signed in, and you are done.
- Works with your organization's existing security policies — multi-factor authentication (MFA), conditional access, and other Microsoft security rules apply automatically.
- New users can be provisioned automatically — if your administrator has enabled auto-provisioning, signing in for the first time creates your RAPTIX account on the spot; you do not need to wait for IT to set it up manually.
- Secure by design — the platform never sees or stores your Microsoft password. Microsoft handles all credential validation directly.
- Protection against link-hijacking — an automatic security check validates the sign-in flow from start to finish, so a manipulated or replayed login attempt is rejected.
Before you start
- Microsoft SSO must be enabled for your organization. If the Continue with Microsoft button does not appear on the login page, SSO has not been configured. Contact your administrator.
- You need a Microsoft work or school account (for example,
[email protected]). Personal Microsoft accounts (Outlook.com, Hotmail.com) may not be supported depending on your organization's setup. - Your Microsoft account's email address must either match an existing RAPTIX account or your administrator must have enabled automatic account creation.
- After your account is created or matched, a role must be assigned before you can access the platform. If you sign in successfully with Microsoft but see a message about no roles, contact your administrator.
How to use it — step by step
-
Open your organization's RAPTIX URL (for example,
https://<workspace>.raptix.app). The login page appears. -
Click the Continue with Microsoft button near the bottom of the login form.
-
The button label changes to Connecting to Microsoft… and a spinner appears while the platform prepares the redirect. Wait a moment — do not close the tab.
-
Your browser is automatically redirected to the Microsoft sign-in page.
- If you are already signed in to Microsoft in this browser, Microsoft may complete the step silently and redirect you back immediately, or it may ask you to confirm your account by clicking your name.
- If you are not yet signed in to Microsoft, enter your Microsoft email address and password (and complete any multi-factor authentication your organization requires).
Note: You are now on Microsoft's own sign-in page — not on RAPTIX. RAPTIX does not see your Microsoft password at any point.
-
After Microsoft confirms your identity, your browser is automatically redirected back to the RAPTIX platform.
-
RAPTIX verifies your Microsoft identity and either matches it to your existing account or (if auto-provisioning is enabled) creates a new account for you.
-
You arrive on the RAPTIX Home screen, fully signed in.
Options & settings explained
| Element | What it does |
|---|---|
| Continue with Microsoft button | Starts the Microsoft SSO flow. Clicking it redirects your browser to Microsoft's login page. If SSO is not configured, this button does not appear. |
| Microsoft sign-in page | Handled entirely by Microsoft. Enter your work or school email and password here. RAPTIX does not see this page or your credentials. |
| Multi-factor authentication (MFA) prompts | These come from Microsoft, not RAPTIX. Complete them as you normally would for other Microsoft services. |
| Automatic redirect back | After Microsoft confirms your identity, the browser returns to RAPTIX automatically. No extra steps are needed. |
Error messages you may see
| Message | What it means | What to do |
|---|---|---|
| "Failed to initiate Microsoft login" | The platform could not start the SSO flow, usually because SSO has not been configured. | Contact your administrator. |
| "Microsoft authentication failed: …" | Microsoft rejected the login attempt (for example, your account is disabled in Microsoft). | Check with your IT department regarding your Microsoft account status. |
| "Invalid or expired OAuth state. Please start the login process again." | The SSO session timed out or the browser navigated away and back. | Return to the RAPTIX login page and click Continue with Microsoft again. |
| "Your account has been created but no roles have been assigned yet. Please contact your administrator to grant you access permissions." | You signed in successfully with Microsoft, and your account was auto-created, but no access roles have been assigned yet. | Contact your administrator to have a role assigned to your new account. |
| "This authorization code has already been processed. Please try logging in again." | The browser submitted the same authentication response twice (for example, by refreshing the callback page). | Return to the login page and start the SSO flow again. |
Tips & best practices
- Keep your Microsoft account signed in in the browser you use for RAPTIX. This makes SSO almost instant — you click Continue with Microsoft and you are already in.
- Do not refresh the callback page. After Microsoft redirects you back to RAPTIX, let the page load completely. Refreshing during this step can cause the "already processed" error.
- If SSO fails, try username/password as a fallback (if your administrator has also set a password for your account). This is useful if Microsoft's sign-in service has a temporary outage.
- For shared computers, sign out of both RAPTIX and Microsoft when you are finished. Signing out of RAPTIX alone may leave your Microsoft session active in the browser.
- If you are a new user, wait a minute after your first SSO sign-in for your account to be fully provisioned, then ask your administrator to confirm a role has been assigned before trying to access specific modules.
Frequently asked questions
Q: Do I need a separate RAPTIX password if I use Microsoft SSO? No. If you always sign in via Microsoft, you do not need a separate RAPTIX password. However, your administrator may have set one up for you as a fallback, in which case you can also use the username/password form.
Q: What happens if Microsoft is down or unavailable? If Microsoft's sign-in service is temporarily unreachable, the SSO flow will fail. If your account also has a username and password configured on the platform, you can use those to sign in instead. If you do not have a password set, contact your administrator.
Q: The Microsoft sign-in page is asking for MFA. Is that normal? Yes. Multi-factor authentication is controlled by your organization's Microsoft policies, not by RAPTIX. Complete the MFA step as you normally would for Microsoft 365 services.
Q: I signed in with Microsoft and got a message saying my account has no roles. What should I do? Your Microsoft identity was recognized, but no permissions have been assigned to your RAPTIX account yet. Contact your administrator and ask them to assign you a role. Once a role is assigned, sign in again and you will have access.
Q: My organization uses Outlook.com email addresses. Can I use those? It depends on whether your administrator configured SSO for personal Microsoft accounts. Most organizations configure SSO for work/school accounts only. Check with your IT department.
Q: I was redirected back to RAPTIX but the page is blank or shows an error. What should I do? Go back to the login page (navigate to your RAPTIX URL directly) and try again. If the problem repeats, clear your browser cookies for the site and try once more, or try a different browser.
Q: Can the platform see my Microsoft password? No. Your browser communicates directly with Microsoft for authentication. RAPTIX only receives a confirmation that Microsoft validated your identity — it never sees or stores your Microsoft password.