Skip to content

Commit 9cbacca

Browse files
authored
Merge pull request #50955 from baardhermansen/patch-1
Update mondaycom-tutorial.md
2 parents 96233b3 + 1183347 commit 9cbacca

File tree

1 file changed

+27
-28
lines changed

1 file changed

+27
-28
lines changed

articles/active-directory/saas-apps/mondaycom-tutorial.md

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,6 @@ To configure the integration of monday.com into Azure AD, you need to add monday
5555
1. In the **Add from the gallery** section, type **monday.com** in the search box.
5656
1. Select **monday.com** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
5757

58-
5958
## Configure and test Azure AD single sign-on for monday.com
6059

6160
Configure and test Azure AD SSO with monday.com using a test user called **B.Simon**. For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in monday.com.
@@ -81,50 +80,50 @@ Follow these steps to enable Azure AD SSO in the Azure portal.
8180

8281
1. On the **Basic SAML Configuration** section, if you have **Service Provider metadata file** and wish to configure in **IDP** initiated mode, perform the following steps:
8382

84-
a. Click **Upload metadata file**.
83+
a. Click **Upload metadata file**.
8584

8685
![Upload metadata file](common/upload-metadata.png)
8786

88-
b. Click on **folder logo** to select the metadata file and click **Upload**.
87+
b. Click on **folder logo** to select the metadata file and click **Upload**.
8988

90-
![choose metadata file](common/browse-upload-metadata.png)
89+
![choose metadata file](common/browse-upload-metadata.png)
9190

92-
c. After the metadata file is successfully uploaded, the **Identifier** and **Reply URL** values get auto populated in Basic SAML Configuration section.
91+
c. After the metadata file is successfully uploaded, the **Identifier** and **Reply URL** values get auto populated in Basic SAML Configuration section.
9392

94-
![image](common/idp-intiated.png)
93+
![image](common/idp-intiated.png)
9594

96-
> [!Note]
97-
> If the **Identifier** and **Reply URL** values do not get populated automatically, then fill in the values manually. The **Identifier** and the **Reply URL** are the same and value is in the following pattern: `https://<your-domain>.monday.com/saml/saml_callback`
95+
> [!Note]
96+
> If the **Identifier** and **Reply URL** values do not get populated automatically, then fill in the values manually. The **Identifier** and the **Reply URL** are the same and value is in the following pattern: `https://<your-domain>.monday.com/saml/saml_callback`
9897
9998
1. Click **Set additional URLs** and perform the following step if you wish to configure the application in **SP** initiated mode:
10099

101-
![image](common/metadata-upload-additional-signon.png)
100+
![image](common/metadata-upload-additional-signon.png)
102101

103-
In the **Sign-on URL** text box, type a URL using the following pattern:
102+
In the **Sign-on URL** text box, type a URL using the following pattern:
104103
`https://<YOUR_DOMAIN>.monday.com`
105104

106-
> [!NOTE]
107-
> These values are not real. Update these values with the actual Identifier, Reply URL and Sign-On URL. Contact [monday.com Client support team](mailto:[email protected]) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
105+
> [!NOTE]
106+
> These values are not real. Update these values with the actual Identifier, Reply URL and Sign-On URL. Contact [monday.com Client support team](https://monday.com/contact-us/) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
108107
109108
1. monday.com 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.
110109

111-
![image](common/default-attributes.png)
110+
![image](common/default-attributes.png)
112111

113112
1. In addition to above, monday.com 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.
114113

115-
| Name | Source Attribute|
116-
| ---------------| --------------- |
117-
| Email | user.mail |
114+
| Name | Source Attribute |
115+
|--|--|
116+
| Email | user.mail |
118117
| FirstName | user.givenname |
119118
| LastName | user.surname |
120119

121120
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.
122121

123-
![The Certificate download link](common/certificatebase64.png)
122+
![The Certificate download link](common/certificatebase64.png)
124123

125124
1. On the **Set up monday.com** section, copy the appropriate URL(s) based on your requirement.
126125

127-
![Copy configuration URLs](common/copy-configuration-urls.png)
126+
![Copy configuration URLs](common/copy-configuration-urls.png)
128127

129128
### Create an Azure AD test user
130129

@@ -133,7 +132,7 @@ In this section, you'll create a test user in the Azure portal called B.Simon.
133132
1. From the left pane in the Azure portal, select **Azure Active Directory**, select **Users**, and then select **All users**.
134133
1. Select **New user** at the top of the screen.
135134
1. In the **User** properties, follow these steps:
136-
1. In the **Name** field, enter `B.Simon`.
135+
1. In the **Name** field, enter `B.Simon`.
137136
1. In the **User name** field, enter the [email protected]. For example, `[email protected]`.
138137
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
139138
1. Click **Create**.
@@ -150,7 +149,7 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
150149

151150
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
152151

153-
![The Add User link](common/add-assign-user.png)
152+
![The Add User link](common/add-assign-user.png)
154153

155154
1. In the **Users and groups** dialog, select **B.Simon** from the Users list, then click the **Select** button at the bottom of the screen.
156155
1. If you're expecting any role value in the SAML assertion, in the **Select Role** dialog, select the appropriate role for the user from the list and then click the **Select** button at the bottom of the screen.
@@ -160,17 +159,17 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
160159

161160
1. To automate the configuration within monday.com, you need to install **My Apps Secure Sign-in browser extension** by clicking **Install the extension**.
162161

163-
![My apps extension](common/install-myappssecure-extension.png)
162+
![My apps extension](common/install-myappssecure-extension.png)
164163

165164
1. After adding extension to the browser, click on **Setup monday.com** which will direct you to the monday.com application. From there, provide the admin credentials to sign into monday.com. The browser extension will automatically configure the application for you and automate steps 3-6.
166165

167-
![Setup configuration](common/setup-sso.png)
166+
![Setup configuration](common/setup-sso.png)
168167

169168
1. If you want to setup monday.com manually, open a new web browser window and sign in to monday.com as an administrator and perform the following steps:
170169

171170
1. Go to the **Profile** on the top right corner of page and click on **Admin**.
172171

173-
![monday.com configuration](./media/mondaycom-tutorial/configuration01.png)
172+
![monday.com configuration](./media/mondaycom-tutorial/configuration01.png)
174173

175174
1. Select **Security** and make sure to click on **Open** next to SAML.
176175

@@ -180,8 +179,8 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
180179

181180
![monday.com configuration](./media/mondaycom-tutorial/configuration03.png)
182181

183-
>[!NOTE]
184-
>For more details refer [this](https://support.monday.com/hc/articles/360000460605-SAML-Single-Sign-on?abcb=34642) article
182+
> [!NOTE]
183+
> For more details refer [this](https://support.monday.com/hc/articles/360000460605-SAML-Single-Sign-on?abcb=34642) article
185184
186185
### Create monday.com test user
187186

@@ -195,10 +194,10 @@ When you click the monday.com tile in the Access Panel, you should be automatica
195194

196195
## Additional resources
197196

198-
- [ List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory ](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
197+
- [List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
199198

200-
- [What is application access and single sign-on with Azure Active Directory? ](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
199+
- [What is application access and single sign-on with Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
201200

202201
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
203202

204-
- [Try monday.com with Azure AD](https://aad.portal.azure.com/)
203+
- [Try monday.com with Azure AD](https://aad.portal.azure.com/)

0 commit comments

Comments
 (0)