OneLogin Desktop Basic allows users log in to a computer using their domain username and password. The unique feature specific to OneLogin Desktop Basic is that a computer can function as a kiosk, allowing multiple users to access the OneLogin Portal and OneLogin managed apps at different times. Users aren't bound to one device and can log in to any available computer with OneLogin Desktop Basic installed. Essentially, one machine can act as a terminal for multiple users.
The kiosk functionality is facilitated by the Tray app, which is located near the status menu in the menu bar. Use the Tray app to log in with your OneLogin credentials and access the OneLogin portal or your SSO-enabled apps, without providing your credentials again. Once you're finished using the machine, log out so another user can access OneLogin.
To get started with OneLogin Desktop Basic, run the installer and complete the installation steps detailed below.
This article is intended for end-users. It includes the following topics:
- System requirements
- Install OneLogin Desktop for Mac
- Tray App
- Upgrade your OneLogin Desktop account
- Change your password
For administrator documentation, see Manage Macs Using OneLogin Desktop.
- Mac OS X 10.11+
- Macs can join an Active Directory domain.
- If you enable OneLogin Desktop for an existing account on your Mac, that account can't be associated with iCloud.
- Browsers: Chrome or Safari are required to use the certificate to provide access to the OneLogin portal or SSO-enabled apps without having to reauthenticate.
Install OneLogin Desktop for Mac
Log in to your Mac using an account with administrator privileges for the machine.
Log out of any other accounts running on your Mac.
Open a browser and log in to OneLogin.
Go to your user Profile page.
On the Profile page's Security tab (which opens by default), go to the OneLogin Desktop for Mac section and click the Download link to get the installer.
Double-click the downloaded OneLogin Desktop installer file.
A new Finder window opens, displaying the OneLogin app and the Uninstaller.
Open the OneLogin app.
If you see the message, "OneLogin.app can't be opened because it is from an unidentified developer," click OK and go to System Preferences > Security & Privacy to allow OneLogin.app to be opened.
On the General tab, click Open Anyway.
When the installer launches, Requirements for OneLogin Desktop Installation appears.
If you meet all of the installation requirements--your battery is charged at least 10% or your computer is plugged in, and you are connected to the internet--click the Continue button.
If you fail to meet one of the requirements, a yellow exclamation point displays next to the unmet requirement. If you're internet is disconnected or you don't have sufficient power (your computer isn't plugged in or you don't have at least 10% battery life), then the Continue button is grayed out.
You must resolve the missing requirement. Don't cancel and rerun the installer if you can remedy the missing requirement while the installer is running.
Note: The power requirement exists to protect you from an incomplete installation.
Note: Logging is turned on by default. You can turn it off at any time by clearing the Turn on Logging checkbox, but logging can help your admin if you run into issues during installation.
On the OneLogin Desktop Terms of Service page, scroll to the bottom of the terms (oh yeah, and read them), then click the I agree button.
When the welcome screen appears, click Start.
At the helper tool prompt, provide the password of the admin account you are logged in as and click Install Helper.
On the Select Installation Type page, choose Basic or Full install.
- Select Basic and click Next.
Enter your domain (the "yourcompany" part of
yourcompany.onelogin.com) and click Next.
The next screen displays your company's OneLogin login screen; enter your OneLogin username and password and click Log In.
If you have a OneLogin Desktop account on your Mac, you can't create a new account, but you can enable a different existing account as your OneLogin Desktop account.
Important! If you enable an existing account, it cannot use iCloud keychain. If you want to enable OneLogin Desktop for an account that uses iCloud keychain, exit the installer and disable iCloud keychain before rerunning the installer.
Important! If you have only one admin account on your Mac, don't enable it for OneLogin Desktop. Your Mac should always have a local admin account that is not enabled for OneLogin Desktop.
Once the installation completes, you're prompted with the message that indicates successful installation, click Done.
OneLogin Desktop Basic enables different users to log in and out of OneLogin Desktop with the Tray app. A computer can function as a kiosk, allowing multiple users to access the OneLogin Portal and OneLogin managed apps at different times. Users aren't bound to one device and can log in to any available computer with OneLogin Desktop Basic installed. Essentially, one machine can act as a terminal for multiple users.
Users can generate a new certificates in the Tray app, if the previous certificate expired.
The Tray app icon is located near the status menu, on the menu bar, and looks like this:
Click on the icon to open the Tray app, and click Log In.
Enter your OneLogin username and password and click Log In.
Once you successfully log in, the Tray app menu displays.
If the certificate has expired, click Generate new certificate. Once you click this, a confirmation screen appears.
Once finished using OneLogin Desktop, click Log out on the Tray app menu. On the confirmation dialog, select Yes, Log Out.
Change your password
You cannot change your password on your Mac. You must change it using OneLogin.
To change your password:
Open a browser and log in to your OneLogin portal.
Go to your user Profile page.
Select Change Password.
Enter your current password and your new password
Log out of your Mac.
When you log back in, use your new password.