Skip to content

Commit 3a014e5

Browse files
authored
Merge pull request #52070 from bettlebrox/patch-1
Initial updates
2 parents 4959390 + 968c7a0 commit 3a014e5

File tree

1 file changed

+30
-14
lines changed

1 file changed

+30
-14
lines changed

articles/active-directory/saas-apps/nitro-productivity-suite-tutorial.md

Lines changed: 30 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ To learn more about SaaS app integration with Azure AD, see [What is application
3434
To get started, you need the following items:
3535

3636
* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
37-
* Nitro Productivity Suite single sign-on (SSO) enabled subscription.
37+
* A Nitro Productivity Suite [Enterprise subscription](https://www.gonitro.com/pricing).
3838

3939
## Scenario description
4040

@@ -75,43 +75,59 @@ Follow these steps to enable Azure AD SSO in the Azure portal.
7575

7676
1. In the [Azure portal](https://portal.azure.com/), on the **Nitro Productivity Suite** application integration page, find the **Manage** section and select **single sign-on**.
7777
1. On the **Select a single sign-on method** page, select **SAML**.
78-
1. On the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
78+
1. On the **SAML Signing Certificate** section:
79+
80+
a. Find **Certificate (Base64)** and select **Download** to download the certificate and save it on your computer.
81+
82+
![The Certificate download link](common/certificatebase64.png)
83+
84+
1. On the **Set up Nitro Productivity Suite** section:
85+
86+
a. Click the copy icon beside **Login URL**
87+
88+
![Copy configuration URLs](common/copy-configuration-urls.png)
89+
90+
1. In the [Nitro Admin portal](https://admin.gonitro.com/), on the **Enterprise Settings** page find the **Single Sign-On** section and click the **Setup SAML SSO** button.
91+
92+
a. Paste the **Login URL** from the step above into the **Sign In URL** field.
93+
94+
a. Upload the **Certificate (Base64)** from the earlier step above in the **X509 Signing Certificate** field.
95+
96+
a. Click **Submit**
97+
98+
a. Click **Enable Single Sign-On**
99+
100+
101+
1. Return to the [Azure portal](https://portal.azure.com/), on the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
79102

80103
![Edit Basic SAML Configuration](common/edit-urls.png)
81104

82105
1. On the **Basic SAML Configuration** section, if you wish to configure the application in **IDP** initiated mode, enter the values for the following fields:
83106

84-
a. In the **Identifier** text box, type a URL using the following pattern:
107+
a. In the **Identifier** text box, copy and paste the **SAML Entity ID** field from the [Nitro Admin portal](https://admin.gonitro.com/). It should have the following pattern:
85108
`urn:auth0:gonitro-prod:<ENVIRONMENT>`
86109

87-
b. In the **Reply URL** text box, type a URL using the following pattern:
110+
b. In the **Reply URL** text box, copy and paste the **ACS URL** field from the [Nitro Admin portal](https://admin.gonitro.com/). It should have the following pattern:
88111
`https://gonitro-prod.eu.auth0.com/login/callback?connection=<ENVIRONMENT>`
89112

90113
1. Click **Set additional URLs** and perform the following step if you wish to configure the application in **SP** initiated mode:
91114

92115
In the **Sign-on URL** text box, type the URL:
93116
`https://sso.gonitro.com/login`
94117

95-
> [!NOTE]
96-
> These values are not real. Update these values with the actual Identifier and Reply URL. Contact [Nitro Productivity Suite Client support team](https://www.gonitro.com/support) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
118+
1. Click Save.
97119

98120
1. Nitro Productivity Suite application expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. The following screenshot shows the list of default attributes.
99121

100122
![image](common/default-attributes.png)
101123

102-
1. In addition to above, Nitro Productivity Suite application expects few more attributes to be passed back in SAML response which are shown below. These attributes are also pre populated but you can review them as per your requirements.
124+
1. In addition, the Nitro Productivity Suite application expects a few more attributes to be passed back in the SAML response, as shown in the following table. These attributes are prepopulated, but you can review them per your requirements.
103125

104126
| Name | Source Attribute|
105-
| ---------------| --------------- | --------- |
127+
| ---------------| --------------- |
106128
| employeeNumber | user.objectid |
107129

108-
1. On the **Set up single sign-on with SAML** page, in the **SAML Signing Certificate** section, find **Certificate (Base64)** and select **Download** to download the certificate and save it on your computer.
109-
110-
![The Certificate download link](common/certificatebase64.png)
111-
112-
1. On the **Set up Nitro Productivity Suite** section, copy the appropriate URL(s) based on your requirement.
113130

114-
![Copy configuration URLs](common/copy-configuration-urls.png)
115131
### Create an Azure AD test user
116132

117133
In this section, you'll create a test user in the Azure portal called B.Simon.

0 commit comments

Comments
 (0)