Skip to content

Commit 909c7a9

Browse files
authored
Merge pull request #63106 from Munaafg/patch-1
Update samsara-tutorial.md
2 parents fa11b1a + 7b8b6ac commit 909c7a9

File tree

1 file changed

+28
-8
lines changed

1 file changed

+28
-8
lines changed

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

Lines changed: 28 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ To get started, you need the following items:
3333

3434
In this tutorial, you configure and test Azure AD SSO in a test environment.
3535

36-
* Samsara supports **SP** initiated SSO
36+
* Samsara supports **SP** and **IDP** initiated SSO
3737
* Samsara supports **Just In Time** user provisioning
3838

3939
## Adding Samsara from the gallery
@@ -42,9 +42,21 @@ To configure the integration of Samsara into Azure AD, you need to add Samsara f
4242

4343
1. Sign in to the Azure portal using either a work or school account, or a personal Microsoft account.
4444
1. On the left navigation pane, select the **Azure Active Directory** service.
45+
46+
![The Azure Active Directory button](common/select-azuread.png)
47+
4548
1. Navigate to **Enterprise Applications** and then select **All Applications**.
49+
50+
![The Enterprise applications blade](common/enterprise-applications.png)
51+
4652
1. To add new application, select **New application**.
53+
54+
![The New application button](common/add-new-app.png)
55+
4756
1. In the **Add from the gallery** section, type **Samsara** in the search box.
57+
58+
![OneTrust Privacy Management Software in the results list](common/search-new-app.png)
59+
4860
1. Select **Samsara** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
4961

5062

@@ -66,32 +78,40 @@ To configure and test Azure AD SSO with Samsara, perform the following steps:
6678
Follow these steps to enable Azure AD SSO in the Azure portal.
6779

6880
1. In the Azure portal, on the **Samsara** application integration page, find the **Manage** section and select **single sign-on**.
81+
82+
![Configure single sign-on link](common/select-sso.png)
83+
6984
1. On the **Select a single sign-on method** page, select **SAML**.
85+
86+
![Single sign-on select mode](common/select-saml-option.png)
87+
7088
1. On the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
7189

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

7492
1. On the **Basic SAML Configuration** section, enter the values for the following fields:
7593

7694
a. In the **Sign-on URL** text box, type a URL using the following pattern:
77-
`https://cloud.samsara.com/signin/<CUSTOMID>`
95+
`https://cloud.samsara.com/signin/<ORGID>` for US cloud customers
96+
`https://cloud.eu.samsara.com/signin/<ORGID>` for EU cloud customers
7897

7998
b. In the **Identifier (Entity ID)** text box, type a URL using the following pattern:
80-
`urn:auth0:samsara-<ENVIRONMENT>:samlp-orgid-<CUSTOMID>`
99+
`urn:auth0:samsara-dev:samlp-orgid-<ORGID>`
81100

82101
c. In the **Reply URL** text box, type a URL using the following pattern:
83-
`https://<SUBDOMAIN>.auth0.com/login/callback?connection=samlp-orgid-<CUSTOMID>`
102+
`https://samsara-dev.auth0.com/login/callback?connection=samlp-orgid-<ORGID>`
84103

85104
> [!NOTE]
86-
> These values are not real. Update these values with the actual Sign on URL, Reply URL and Identifier. Contact [Samsara 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+
> These values are not real. Update these values with the actual Sign-on URL, Reply URL, and Identifier. Contact the [Samsara Client support team](mailto:[email protected]) to get these values, or in Samsara, go to **Settings** > **Single-Sign-On** > **New SAML Connection** to obtain the \<ORGID\>. You also can refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
87106

88107
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.
89108

90109
![The Certificate download link](common/certificatebase64.png)
91110

92-
1. On the **Set up Samsara** section, copy the appropriate URL(s) based on your requirement.
111+
1. On the **Set up Samsara** section, copy the **login URL**
93112

94113
![Copy configuration URLs](common/copy-configuration-urls.png)
114+
95115
### Create an Azure AD test user
96116

97117
In this section, you'll create a test user in the Azure portal called B.Simon.
@@ -118,11 +138,11 @@ In this section, you'll enable B.Simon to use Azure single sign-on by granting a
118138

119139
## Configure Samsara SSO
120140

121-
To configure single sign-on on **Samsara** side, you need to send the downloaded **Certificate (Base64)** and appropriate copied URLs from Azure portal to [Samsara support team](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides.
141+
To configure single sign-on on **Samsara** side, you need to send the downloaded **Certificate (Base64)** and **Login URL** from Azure portal to [Samsara support team](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides.
122142

123143
### Create Samsara test user
124144

125-
In this section, a user called Britta Simon is created in Samsara. Samsara supports just-in-time user provisioning, which is enabled by default. There is no action item for you in this section. If a user doesn't already exist in Samsara, a new one is created after authentication.
145+
In this section, a user called B.Simon is created in Samsara. Samsara supports just-in-time user provisioning, which is enabled by default. There is no action item for you in this section. If a user doesn't already exist in Samsara, a new one is created after authentication with a default role of Standard Admin (No Dash Cam Access) for Organization. The user's access can then be increased or decreased as needed in Samsara.
126146

127147
## Test SSO
128148

0 commit comments

Comments
 (0)