Skip to main content

Bulk Update Login Method to Single Sign-On (SSO)

This guide explains how to bulk update staff accounts from Orah login to Single Sign-On (SSO) using Reset Credentials. Resetting credentials moves Active users back to Imported so their login method can be reconfigured for SSO access.

What this article covers: the bulk migration of existing staff accounts to Single Sign-On. If you are troubleshooting one user who cannot log in, do not reset credentials for everyone — check that single account's authentication profile and email address first, or contact Orah support.


🧩 Overview

Staff accounts in Orah move through the following account states:

Imported → Configured → Invited (password login only) → Active → Suspended

When users are already Active, their login method cannot be changed directly. Resetting credentials moves the accounts back to Imported, allowing them to be configured again with a new login method such as SSO.

Resetting credentials:

  • Removes existing login credentials

  • Changes account status back to Imported

  • Allows accounts to be reconfigured with SSO

  • Does not delete user accounts or data

Applies to:

✅ Orah Admins

✅ IT Administrators


🧭 Step-by-Step Instructions

Step 1 — Open the Staff List

  1. Log in to Orah as an administrator

  2. Go to Admin Console → Staff

  3. Click Filter on the right side

  4. Under Account Status, select: Active

The list will now show all active staff accounts.
​


Step 2 — Reset Credentials in Bulk

  1. Select the checkbox at the top of the list to select all users

  2. Click More Actions

  3. Select Reset Credentials

This will:

  • Remove user login credentials

  • Change account status to Imported

  • Allow accounts to be reconfigured with SSO
    ​


Step 4 — Configure Accounts for SSO

  1. Select the users again

  2. Click More Actions

  3. Click Configure account

  4. Configure authentication using your SSO login method
    ​

Depending on your school’s authentication setup:

  • If password login is enabled, you may need to send invitation emails so users can set passwords.

  • If SSO is enforced, users can usually log in through the Identity Provider once configured and may not need an invitation email.
    ​


Suspended accounts

An account in the Suspended state cannot be restored to Active from the interface. There is no "reactivate" action.

To give that person access again:

  1. Delete the suspended account.

  2. Send them a fresh invitation.

If you are not sure whether an account should be deleted, contact Orah support before you remove it.


💡 Important Notes

  • Users must exist in your Identity Provider (Google, Microsoft, etc.).

  • User email addresses must match the Identity Provider.

  • Resetting credentials does not delete user accounts or data.


❓ FAQs

Q: Will users lose their data if credentials are reset?

No. Resetting credentials only changes login access. User data remains unchanged.


Q: Do users need a new invitation email?

It depends on your authentication setup:

  • Password login: Users need an invitation email to set a password.

  • SSO login: Users can usually log in through the Identity Provider once configured and may not need an invitation email.


Q: Can I switch only some users to SSO?

Yes. Instead of selecting all users, select only the users you want to update.


🔧 Troubleshooting

Users cannot log in after SSO setup

Check that:

  • The user exists in your Identity Provider

  • The user’s email matches Orah

  • The user is configured with the correct SSO profile

  • Identity Provider identifier mapping is correct


Users still see password login errors

This may happen if:

  • The account is still configured for Orah login

  • The SSO profile was not applied correctly

  • Identity Provider details do not match the Orah account

Try resetting credentials and configuring SSO again once.

If the user can sign in on the website but not in the Orah Staff app, the phone may be using a personal Google account. On the phone, open Safari, go to google.com, add the school Google Workspace account, then open the Orah Staff app and choose the school account when asked.

If the user still can't sign in, don't reset credentials again. Contact Orah support with the user's email address.


If you need additional support, please contact Orah Support.

Did this answer your question?