# Logging in with SSO

### Introduction

Unifize supports Single Sign-On (SSO), allowing you to log in with your existing company credentials — such as those you use for Microsoft 365, Google Workspace, or another identity provider. This feature replaces the need for a separate Unifize password and allows seamless access to the platform.

If your organisation has SSO enabled, you will be automatically routed through your company’s login page after entering your work email address. If your organisation has configured more than one SSO connection, Unifize will detect your email domain and route you to the correct login portal automatically. This applies to both the web platform and the mobile app.

***

### Why SSO Is Useful

SSO enhances the login experience by integrating with your organisation’s existing authentication system. Here’s why it matters:

<br>

* Secure by default: Your credentials never pass through Unifize. Authentication is handled directly by your company’s identity provider.
* Simplifies access: No need to create or remember a separate password for Unifize.
* IT-aligned: Helps organisations manage access centrally using existing systems like Azure AD or Google Workspace.
* Supports MFA (Multi-Factor Authentication): If your company uses 2FA, SSO supports that too — providing added security.

***

### Who Can Use SSO

You can use SSO to log into Unifize if:

* Your organisation has enabled SSO in their Org Settings
* Your email domain (e.g., @yourcompany.com) has been configured for SSO
* You have been added as a user in your company’s identity provider system (e.g., Azure AD)

If you’re not sure whether your company uses SSO, ask your IT administrator or Unifize workspace admin.

***

### How to Log In with SSO

#### On Desktop (Browser)

1. Open your browser and go to <https://app.unifize.com>
2. Enter your work email address
3. Unifize checks if your domain is SSO-enabled:
4. If yes, you are redirected to your company’s login portal
5. If no, you’ll see the traditional password field (for standard users)
6. Log in using your corporate credentials (email + password)
7. Complete any required MFA (multi-factor authentication) steps
8. You’ll be logged into Unifize and redirected to your workspace

| ℹ️  Even if it’s your first time using Unifize, you don’t need to create a new password — SSO will handle the login. |
| -------------------------------------------------------------------------------------------------------------------- |

#### On Mobile (iOS / Android)

7. Open the Unifize app on your phone or tablet
8. Enter your work email address
9. You’ll be redirected to your company’s login page within the app
10. Complete your usual login flow and MFA (if applicable)
11. Once authenticated, you’ll return to the app — logged in and ready to go

| ℹ️  Mobile login flow is nearly identical to the web experience, adapted for mobile screens. |
| -------------------------------------------------------------------------------------------- |

***

### Digital Signatures and OTP (for SSO Users)

In Unifize, some workflows require digital signature confirmation during approvals.

Because your password is managed outside Unifize when using SSO, you can’t re-enter a password to validate signatures. Instead:

* You’ll receive a One-Time Passcode (OTP) to your registered email
* The OTP is valid for 2 minutes
* Enter the 6-digit code to confirm your signature<br>

This ensures your approvals remain secure and traceable even when using SSO.

***

### Troubleshooting Tips

| Issue                                      | What to Try                                                                                                                     |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Not redirected to your company login       | Make sure your email domain is registered for SSO. Ask your admin to confirm the domain is configured in Org Settings → SSO.    |
| See password field instead of SSO login    | Clear browser cache and retry, or confirm with your admin that your domain is mapped to an SSO tenant.                          |
| Didn’t receive OTP                         | Check your spam/junk folder, or request a resend. Confirm your email in Unifize matches your work email exactly.                |
| Login loop or error from IdP               | Make sure your browser or app allows third-party cookies/redirects.                                                             |
| Mobile login stalls after IdP redirect     | Force-close and reopen the Unifize app, and update to the latest version.                                                       |
| Redirected to the wrong company login page | Your email domain may be mapped to the wrong SSO tenant. Contact your admin to review domain assignments in Org Settings → SSO. |

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.unifize.com/admin-guide/profile/org-settings/sso/logging-in-with-sso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
