Topic
This guide explains how to set up Security Assertion Markup Language (SAML) with NinjaOne using Google Workspace.
Environment
NinjaOne platform
Description
SAML allows technicians to access the NinjaOne application using single sign-on (SSO) with their preferred provider. SAML can be used with both the standard and branded NinjaOne web application, which supports multiple Identity Providers (IdPs).
Any IdP that supports SAML 2.0 may be used. However, we have only tested and verified Azure, OneLogin, and Okta.
There are two different workflows related to SAML. Currently, only the workflow initiated by the service provider is enabled for NinjaOne SAML.
- Service Provider (SP) initiated workflow: You navigate to NinjaOne to log in, and you are forwarded to the identity provider.
- Identity Provider (IdP) initiated workflow: You navigate to your identity provider to log in, and you are forwarded to NinjaOne to log in.
For more information about setting up SSO in NinjaOne, refer to Login Security: Configure Single Sign-On in NinjaOne.
Adding the Google SAML App
To add the Google SAML app in NinjaOne, follow these steps:
- In your browser, navigate to admin.google.com → Apps → Web and mobile apps → Add app → Add custom SAML App.
- Give the application a name and click Continue.
- Google will direct you to a page titled Google Identity Provider Detail. Click Download MetaData.
- In NinjaOne, navigate to Administration → Accounts → Identity Providers → Add Provider. The Configure SSO page will open.
- In the Import Metadata from field, select File from the drop-down menu. Upload the metadata XML file you downloaded in the previous step.
- Copy the Reply URL from NinjaOne, and paste it into the ACS URL section on the Google site.
- Copy the SP Identifier (Entity ID) from NinjaOne and paste it into the Entity ID field in Google. Start URL can remain blank, but you should check Signed response. Copy all of this information down, as you will not be able to access it again.
- In Google, set the Name ID format to EMAIL and the Name ID to Basic Information → Primary email.
- Click Finish.
- In the Google Admin Center, ensure that the service status for the users or groups who will use the app is set to ON, or you can select On for everyone. This change may take a few minutes to take effect.
- Navigate back to NinjaOne. The Configure SSO Screen should still be open. Click Test Connection.
- Click Save.
- Since Google does not have SCIM, you will need to create your users manually before they can use SSO in NinjaOne. In NinjaOne, navigate to + → Add User. Select the user type, assign the user a role, and enter a name and email.
- Click the Security tab. Change the user's authentication type from Native to SSO.
- Click Save.
- During setup, make sure to click the Signed Response button and change the Name ID format to email at the bottom of the page.
- To successfully set up SSO in NinjaOne, we recommend you open a new browser or an incognito window. If you try to do this in a browser while already logged in to Google Workspace, the process may fail.
Additional Resources
To learn more about NinjaOne's identity services, refer to: