GSuite with Just-In-Time Provisioning


Goal

After completing this setup guide, you will have setup GSuite AD with Just-In-Time Provisioning and your Atlassian product for the SAML SSO app. Additionally, you will test SSO and enable the SSO redirection.



Prerequisites

To use the SAML SSO app with GSuite, you need the following:

  • A GSuite subscription

  • A (trial) subscription for the SAML SSO app

  • Admin access to your Atlassian product

  • You mange your groups locally on your Atlassian product

Video Guide

Here you will find a detailed video guide soon.




Step-by-Step Setup Guide

Configure GSuite for the SAML SSO App

Go to http://admin.google.com and click on "Apps".


g1.png


Afterwards, click on "SAML apps".


g2.png



Next, click on the yellow plus symbol in the right downer corner.

g3.png



In the next window, click on "SETUP MY OWN CUSTOM APP".

g4.png



Next, click "DOWNLOAD" at "Option 2". Save the file to your computer and click "NEXT".

g5.png



Give a "Application Name" and click on "NEXT". 

g6.png



Next, for "ACS URL" and "Entity ID" enter "https://<base-url>/plugins/servlet/samlsso" (without quotes) and substitute "<baseURL>" with the URL to your Atlassian product.

For "Name ID", make sure that "Basic Information" and "Primary Email" are chosen and that "Name ID Format" is set to "UNSPECIFIED".

Click "NEXT" to continue.

g7.png



Click on "ADD MAPPING".

image2022-7-12_10-23-11.png


Under "Basic Information", select "First name", and enter "firstName" (without quotes) as the App attribute.

image2022-7-12_10-24-4.png


Similarly, add "lastName" and "mail" attributes. 

image2022-7-12_10-27-0.png

Optionally, if you would like to also send the Groups attribute in the SAML response, set it in the next section, by selecting all the groups that you want to send (at the moment, you need to select them one by one from the list), then enter "Groups" (without quotes) as the App attribute.

image2022-7-12_10-30-48.png

This is sort of a white list for the groups to be returned in the SAML response, i.e., if you don't add a group in that list, it wouldn't be returned in the Groups attribute in the SAML response, even if the user was a member of another group that you've already added to that list.


Click on "FINISH".


After setting up the app, it is turned OFF. To activate it, click on "OFF for everyone".

image2022-7-12_10-35-44.png


Check "ON for everyone" and click "SAVE".

image2022-7-12_10-36-43.png






Configure Jira for the SAML SSO App

Install the SAML SSO App


In your Atlassian product, open the in-product marketplace as described in the Atlassian documentation.
Search for "resolution saml" and click "Install" for SAML Single Sign On (SSO) by resolution Reichert Network Solutions GmbH


After the installation is complete, click on Manage, then choose Configure

Now, you are on the Add-on / app configuration page and the first step of the setup wizard will appear.


Install-25-loop.gif






Configure the SAML SSO App


After you clicked "Configure", the Wizard will be triggered. If not, or if you want to add another Identity Prover (IdP) to your existing configuration, click on "+ Add IdP". This guide assumes, that you there is no IdP configured.
The Wizard greets you with information, click on "Add new IdP" to proceed.

s81.png




Choose "Google GSuite" for the "IdP Type".

s1.png


Click "Next".

s2.png


Click on "Select Metadata XML File".

s3.png


Select the file you have downloaded before and click "Choose".

s4.png


Click on "Import".

s5.png


Click "Next" to continue.

s6.png





If you configured your Atlassian product and your Identity Provider in a common way, you do not need to change anything here. In that case, just click "Next".

s14.png






For the User Update Method, choose "Update from SAML-Attributes".

jit1.png


The window now expands. There are various options you can set. For this tutorial, new users should be created automatically when first accessing your Atlassian product instace, thus tick "Create New Users". 

You can also choose the directory for new users or to update non-SAML provisioned users, i.e. which are already present in your Atlassian product. By activating the option, they can also be updated via SAML attributes when they log in.

Further, the "Full Name Attribute" and "Email Attribute" must be set. Set the first to "{firstName} {lastName}" and the second to "mail" (both without quotation marks) as configured before.


Since GSuite does not support transmitting groups, click "Save & Next" to continue.

jit2.png





Testing SSO


The wizard also allows to test the Single Sign On. Just follow the steps to test if the login works as expected. 


Click on "Start test" to proceed.
s16.png


Copy the red marked link and open a new incognito/private tab or a different web browser. Then, paste the link and navigate to it. 

s17.png


You will be now redirected to GSuite's login page. Please log-in with you username and password. 


t1.png
t2.png


If everything worked fine, you will logged in into your Atlassian product. In the other tab/browser in which you were configuring the SAML SSO plugin, you can see also the "SUCCESS" status, if everything worked as expected. Click Next to proceed.

s21.png




SSO Redirection


As a last step, you can set the Enable SSO Redirect option. If set, all users will be redirected to Single Sign On, thus they will be logged in via the IdP. Click on Save & Close to finish the configuration.

s22.png