agentOS supports Single Sign-On (SSO) to simplify your login experience and enhance security. There are two methods available depending on your organisation's setup.
Method 1: Using Microsoft Entra
If your organisation uses Microsoft Entra (formerly known as Azure Active Directory), you can use your corporate credentials to access agentOS.
Setting up Microsoft Entra SSO
- Log into agentOS using your standard credentials
- Click on your profile icon in the top right corner
- Navigate to Settings
- Scroll down to Account Settings
- Select Setup agentOS Single Sign-on
- Click the Microsoft-Entra button to authenticate using your corporate ID
What happens next?
When you select Microsoft-Entra, you'll be redirected to a login screen where you can choose between signing in with your corporate ID or using your standard email and password.
After selecting Microsoft-Entra, you'll need to:
- Enter your password on the Microsoft authentication page
- Approve the sign-in request through your Microsoft Authenticator app (or your organisation's chosen authentication method)
- Enter the verification number shown on your device
Once you've approved your login and signed in successfully, you'll have full access to your agentOS account using SSO.
Important notes:
- The Microsoft-Entra option routes you through a separate authentication platform
- You'll need to confirm your login credentials for that platform each time
- Multi-factor authentication may be required depending on your organisation's security settings
Method 2: Setting up using staff profile
If you're not using Microsoft Entra, you can set up SSO through your staff profile. This method requires an administrator to initiate the process on your behalf.
How an administrator sets up SSO for you
An administrator needs to:
- Log into agentOS using the Classic Sign-In option
- Navigate to Settings > Staff
- Find your staff profile
- Select Send Single Sign-On Email
What you'll receive
You'll receive a one-time email at your registered address (External Email 1 in your profile) with the subject "Welcome to agentOS Single Sign-On". This email contains:
- A welcome message explaining the SSO enhancement
- A Set Up Single Sign-On button
- An important note: This link is only valid for 15 minutes
Important: If you don't receive the email, check your spam folder before requesting it to be resent.
Setting up your SSO account
- Click the Set Up Single Sign-On button in the email (within 15 minutes)
- You'll be taken to a secure page where you can create your password
- After setting your password, you'll receive a verification code via email
- Enter the verification code on the confirmation screen
Setting up multi-factor authentication (MFA)
After confirming your account, you'll be prompted to set up an authenticator app for added security:
- Install an authenticator app on your mobile device (such as Microsoft Authenticator, Google Authenticator, or Authy)
- Scan the QR code displayed on screen with your authenticator app
- Alternatively, you can manually enter the secret key
- Enter the code generated by your authenticator app
- Click Complete Setup
You can also choose "No thanks, I'll set it up later" if you prefer to configure MFA at a different time.
Success confirmation
Once setup is complete, you'll receive a success message. You can now use your SSO email address when logging into agentOS.
If you forget your password
If you forget your SSO password:
- Click the Forgot your password? button on the login screen
- Enter the email address you use for SSO
- Click Reset my password
- You'll receive a code via email
- Enter the code and create your new password
If you need assistance with SSO setup or encounter any issues during the process, please contact support@agentos.com.