Skip to content

Commit 94774ae

Browse files
v-hagampv-hagamp
committed
Product Backlog Item 925051: SaaS App Tutorial: Skytap Update
1 parent b71fc64 commit 94774ae

File tree

2 files changed

+77
-124
lines changed

2 files changed

+77
-124
lines changed

‎articles/active-directory/saas-apps/skytap-tutorial.md

Lines changed: 75 additions & 122 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: 'Tutorial: Azure Active Directory integration with Skytap | Microsoft Docs'
3-
description: Learn how to configure single sign-on between Azure Active Directory and Skytap.
2+
title: 'Tutorial: Azure Active Directory single sign-on (SSO) integration with Single Sign-on for Skytap | Microsoft Docs'
3+
description: Learn how to configure single sign-on between Azure Active Directory and Single Sign-on for Skytap.
44
services: active-directory
55
documentationCenter: na
66
author: jeevansd
@@ -12,198 +12,151 @@ ms.service: active-directory
1212
ms.subservice: saas-app-tutorial
1313
ms.workload: identity
1414
ms.tgt_pltfrm: na
15-
ms.devlang: na
1615
ms.topic: tutorial
17-
ms.date: 04/08/2019
16+
ms.date: 02/13/2020
1817
ms.author: jeedes
1918

2019
ms.collection: M365-identity-device-management
2120
---
22-
# Tutorial: Azure Active Directory integration with Skytap
2321

24-
In this tutorial, you learn how to integrate Skytap with Azure Active Directory (Azure AD).
25-
Integrating Skytap with Azure AD provides you with the following benefits:
22+
# Tutorial: Azure Active Directory single sign-on (SSO) integration with Single Sign-on for Skytap
2623

27-
* You can control in Azure AD who has access to Skytap.
28-
* You can enable your users to be automatically signed-in to Skytap (Single Sign-On) with their Azure AD accounts.
29-
* You can manage your accounts in one central location - the Azure portal.
24+
In this tutorial, you'll learn how to integrate Single Sign-on for Skytap with Azure Active Directory (Azure AD). When you integrate Single Sign-on for Skytap with Azure AD, you can:
3025

31-
If you want to know more details about SaaS app integration with Azure AD, see [What is application access and single sign-on with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis).
32-
If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
26+
* Control in Azure AD who has access to Single Sign-on for Skytap.
27+
* Enable your users to be automatically signed-in to Single Sign-on for Skytap with their Azure AD accounts.
28+
* Manage your accounts in one central location - the Azure portal.
29+
30+
To learn more about SaaS app integration with Azure AD, see [What is application access and single sign-on with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on).
3331

3432
## Prerequisites
3533

36-
To configure Azure AD integration with Skytap, you need the following items:
34+
To get started, you need the following items:
3735

38-
* An Azure AD subscription. If you don't have an Azure AD environment, you can get a [free account](https://azure.microsoft.com/free/)
39-
* Skytap single sign-on enabled subscription
36+
* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
37+
* Single Sign-on for Skytap single sign-on (SSO) enabled subscription.
4038

4139
## Scenario description
4240

43-
In this tutorial, you configure and test Azure AD single sign-on in a test environment.
44-
45-
* Skytap supports **SP and IDP** initiated SSO
46-
47-
## Adding Skytap from the gallery
48-
49-
To configure the integration of Skytap into Azure AD, you need to add Skytap from the gallery to your list of managed SaaS apps.
50-
51-
**To add Skytap from the gallery, perform the following steps:**
52-
53-
1. In the **[Azure portal](https://portal.azure.com)**, on the left navigation panel, click the **Azure Active Directory** icon.
54-
55-
![The Azure Active Directory button](common/select-azuread.png)
56-
57-
2. Navigate to **Enterprise Applications** and then select the **All Applications** option.
58-
59-
![The Enterprise applications blade](common/enterprise-applications.png)
41+
In this tutorial, you configure and test Azure AD SSO in a test environment.
6042

61-
3. To add a new application, click the **New application** button at the top of the dialog.
43+
* Single Sign-on for Skytap supports **SP and IDP** initiated SSO
44+
* Once you configure Single Sign-on for Skytap you can enforce session control, which protect exfiltration and infiltration of your organization’s sensitive data in real-time. Session control extend from Conditional Access. [Learn how to enforce session control with Microsoft Cloud App Security](https://docs.microsoft.com/cloud-app-security/proxy-deployment-any-app).
6245

63-
![The New application button](common/add-new-app.png)
46+
## Adding Single Sign-on for Skytap from the gallery
6447

65-
4. In the search box, type **Skytap**, select **Skytap** from the result panel then click the **Add** button to add the application.
48+
To configure the integration of Single Sign-on for Skytap into Azure AD, you need to add Single Sign-on for Skytap from the gallery to your list of managed SaaS apps.
6649

67-
![Skytap in the results list](common/search-new-app.png)
50+
1. Sign in to the [Azure portal](https://portal.azure.com) using either a work or school account, or a personal Microsoft account.
51+
1. On the left navigation pane, select the **Azure Active Directory** service.
52+
1. Navigate to **Enterprise Applications** and then select **All Applications**.
53+
1. To add new application, select **New application**.
54+
1. In the **Add from the gallery** section, type **Single Sign-on for Skytap** in the search box.
55+
1. Select **Single Sign-on for Skytap** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
6856

69-
## Configure and test Azure AD single sign-on
57+
## Configure and test Azure AD single sign-on for Single Sign-on for Skytap
7058

71-
In this section, you configure and test Azure AD single sign-on with Skytap based on a test user called **Britta Simon**.
72-
For single sign-on to work, a link relationship between an Azure AD user and the related user in Skytap needs to be established.
59+
Configure and test Azure AD SSO with Single Sign-on for Skytap 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 Single Sign-on for Skytap.
7360

74-
To configure and test Azure AD single sign-on with Skytap, you need to complete the following building blocks:
61+
To configure and test Azure AD SSO with Single Sign-on for Skytap, complete the following building blocks:
7562

76-
1. **[Configure Azure AD Single Sign-On](#configure-azure-ad-single-sign-on)** - to enable your users to use this feature.
77-
2. **[Configure Skytap Single Sign-On](#configure-skytap-single-sign-on)** - to configure the Single Sign-On settings on application side.
78-
3. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with Britta Simon.
79-
4. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable Britta Simon to use Azure AD single sign-on.
80-
5. **[Create Skytap test user](#create-skytap-test-user)** - to have a counterpart of Britta Simon in Skytap that is linked to the Azure AD representation of user.
81-
6. **[Test single sign-on](#test-single-sign-on)** - to verify whether the configuration works.
63+
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
64+
1. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with B.Simon.
65+
1. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable B.Simon to use Azure AD single sign-on.
66+
1. **[Configure Single Sign-on for Skytap SSO](#configure-single-sign-on-for-skytap-sso)** - to configure the single sign-on settings on application side.
67+
1. **[Create Single Sign-on for Skytap test user](#create-single-sign-on-for-skytap-test-user)** - to have a counterpart of B.Simon in Single Sign-on for Skytap that is linked to the Azure AD representation of user.
68+
1. **[Test SSO](#test-sso)** - to verify whether the configuration works.
8269

83-
### Configure Azure AD single sign-on
70+
## Configure Azure AD SSO
8471

85-
In this section, you enable Azure AD single sign-on in the Azure portal.
72+
Follow these steps to enable Azure AD SSO in the Azure portal.
8673

87-
To configure Azure AD single sign-on with Skytap, perform the following steps:
74+
1. In the [Azure portal](https://portal.azure.com/), on the **Single Sign-on for Skytap** application integration page, find the **Manage** section and select **single sign-on**.
75+
1. On the **Select a single sign-on method** page, select **SAML**.
76+
1. On the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
8877

89-
1. In the [Azure portal](https://portal.azure.com/), on the **Skytap** application integration page, select **Single sign-on**.
78+
![Edit Basic SAML Configuration](common/edit-urls.png)
9079

91-
![Configure single sign-on link](common/select-sso.png)
92-
93-
2. On the **Select a Single sign-on method** dialog, select **SAML/WS-Fed** mode to enable single sign-on.
94-
95-
![Single sign-on select mode](common/select-saml-option.png)
96-
97-
3. On the **Set up Single Sign-On with SAML** page, click **Edit** icon to open **Basic SAML Configuration** dialog.
98-
99-
![Edit Basic SAML Configuration](common/edit-urls.png)
100-
101-
4. On the **Basic SAML Configuration** section, if you wish to configure the application in **IDP** initiated mode, perform the following steps:
102-
103-
![Skytap Domain and URLs single sign-on information](common/idp-intiated.png)
80+
1. On the **Basic SAML Configuration** section, if you wish to configure the application in **IDP** initiated mode, perform the following steps:
10481

10582
a. In the **Identifier** text box, type a URL using the following pattern:
10683
`http://pingone.com/<custom EntityID>`
10784

10885
b. In the **Reply URL** text box, type a URL using the following pattern:
10986
`https://sso.connect.pingidentity.com/sso/sp/ACS.saml2`
11087

111-
5. Click **Set additional URLs** and perform the following steps if you wish to configure the application in **SP** initiated mode:
112-
113-
![Skytap Domain and URLs single sign-on information](common/both-advanced-urls.png)
88+
1. Click **Set additional URLs** and perform the following steps if you wish to configure the application in **SP** initiated mode:
11489

11590
d. In the **Sign-on URL** text box, type a URL using the following pattern:
11691
`https://sso.connect.pingidentity.com/sso/sp/initsso?saasid=<saasid>&idpid=<idpid>`
11792

93+
11894
e. In the **Relay State** text box, type a URL using the following pattern:
11995
`https://pingone.com/1.0/<custom ID>`
12096

12197
> [!NOTE]
122-
> These values are not real. Update these values with the actual Identifier, Reply URL, Sign-on URL and Relay State. Contact [Skytap 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.
98+
> These values are not real. Update these values with the actual Identifier, Reply URL, Sign-on URL and Relay State. Contact [Single Sign-on for Skytap 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.
12399
124-
6. On the **Set up Single Sign-On with SAML** page, in the **SAML Signing Certificate** section, click **Download** to download the **Federation Metadata XML** from the given options as per your requirement and save it on your computer.
100+
1. On the **Set up single sign-on with SAML** page, in the **SAML Signing Certificate** section, find **Federation Metadata XML** and select **Download** to download the metadata file and save it on your computer.
125101

126102
![The Certificate download link](common/metadataxml.png)
127103

128-
7. On the **Set up Skytap** section, copy the appropriate URL(s) as per your requirement.
104+
1. On the **Set up Single Sign-on for Skytap** section, copy the appropriate URL(s) based on your requirement.
129105

130106
![Copy configuration URLs](common/copy-configuration-urls.png)
131107

132-
a. Login URL
133-
134-
b. Azure AD Identifier
108+
### Create an Azure AD test user
135109

136-
c. Logout URL
110+
In this section, you'll create a test user in the Azure portal called B.Simon.
137111

138-
### Configure Skytap Single Sign-On
139-
140-
To configure single sign-on on **Skytap** side, you need to send the downloaded **Federation Metadata XML** and appropriate copied URLs from Azure portal to [Skytap support team](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides.
141-
142-
### Create an Azure AD test user
143-
144-
The objective of this section is to create a test user in the Azure portal called Britta Simon.
145-
146-
1. In the Azure portal, in the left pane, select **Azure Active Directory**, select **Users**, and then select **All users**.
147-
148-
![The "Users and groups" and "All users" links](common/users.png)
149-
150-
2. Select **New user** at the top of the screen.
151-
152-
![New user Button](common/new-user.png)
153-
154-
3. In the User properties, perform the following steps.
155-
156-
![The User dialog box](common/user-properties.png)
157-
158-
a. In the **Name** field enter **BrittaSimon**.
159-
160-
b. In the **User name** field type `[email protected]`. For example, [email protected]
161-
162-
c. Select **Show password** check box, and then write down the value that's displayed in the Password box.
163-
164-
d. Click **Create**.
112+
1. From the left pane in the Azure portal, select **Azure Active Directory**, select **Users**, and then select **All users**.
113+
1. Select **New user** at the top of the screen.
114+
1. In the **User** properties, follow these steps:
115+
1. In the **Name** field, enter `B.Simon`.
116+
1. In the **User name** field, enter the [email protected]. For example, `[email protected]`.
117+
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
118+
1. Click **Create**.
165119

166120
### Assign the Azure AD test user
167121

168-
In this section, you enable Britta Simon to use Azure single sign-on by granting access to Skytap.
122+
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to Single Sign-on for Skytap.
169123

170-
1. In the Azure portal, select **Enterprise Applications**, select **All applications**, then select **Skytap**.
124+
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
125+
1. In the applications list, select **Single Sign-on for Skytap**.
126+
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
171127

172-
![Enterprise applications blade](common/enterprise-applications.png)
128+
![The "Users and groups" link](common/users-groups-blade.png)
173129

174-
2. In the applications list, select **Skytap**.
130+
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
175131

176-
![The Skytap link in the Applications list](common/all-applications.png)
132+
![The Add User link](common/add-assign-user.png)
177133

178-
3. In the menu on the left, select **Users and groups**.
134+
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.
135+
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.
136+
1. In the **Add Assignment** dialog, click the **Assign** button.
179137

180-
![The "Users and groups" link](common/users-groups-blade.png)
138+
## Configure Single Sign-on for Skytap SSO
181139

182-
4. Click the **Add user** button, then select **Users and groups** in the **Add Assignment** dialog.
140+
To configure single sign-on on **Single Sign-on for Skytap** side, you need to send the downloaded **Certificate (Raw)** and appropriate copied URLs from Azure portal to [Single Sign-on for Skytap Client support team](mailto:[email protected]). They set this setting to have the SAML SSO connection set properly on both sides.
183141

184-
![The Add Assignment pane](common/add-assign-user.png)
185142

186-
5. In the **Users and groups** dialog select **Britta Simon** in the Users list, then click the **Select** button at the bottom of the screen.
143+
### Create Single Sign-on for Skytap test user
187144

188-
6. If you are expecting any role value in the SAML assertion then in the **Select Role** dialog select the appropriate role for the user from the list, then click the **Select** button at the bottom of the screen.
145+
In this section, you create a user called Britta Simon in Single Sign-on for Skytap. Work with [Single Sign-on for Skytap Client support team](mailto:[email protected]) to add the users in the Single Sign-on for Skytap platform. Users must be created and activated before you use single sign-on.
189146

190-
7. In the **Add Assignment** dialog click the **Assign** button.
191-
192-
### Create Skytap test user
193-
194-
In this section, you create a user called Britta Simon in Skytap. Any Admininstrator or User Manager within a Skytap Account can create users. More information on how to do this is in Skytap's help files, see: https://help.skytap.com/users-create.html
195-
196-
### Test single sign-on
147+
## Test SSO
197148

198149
In this section, you test your Azure AD single sign-on configuration using the Access Panel.
199150

200-
When you click the Skytap tile in the Access Panel, you should be automatically signed in to the Skytap for which you set up SSO. For more information about the Access Panel, see [Introduction to the Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
151+
When you click the Single Sign-on for Skytap tile in the Access Panel, you should be automatically signed in to the Single Sign-on for Skytap for which you set up SSO. For more information about the Access Panel, see [Introduction to the Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
201152

202153
## Additional resources
203154

204-
- [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)
155+
- [ 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)
156+
157+
- [What is application access and single sign-on with Azure Active Directory? ](https://docs.microsoft.com/azure/active-directory/manage-apps/what-is-single-sign-on)
205158

206-
- [What is application access and single sign-on with Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
159+
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
207160

208-
- [What is Conditional Access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
161+
- [Try Slack with Azure AD](https://aad.portal.azure.com/)
209162

‎articles/active-directory/saas-apps/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1298,8 +1298,8 @@
12981298
href: skyhighnetworks-tutorial.md
12991299
- name: SKYSITE
13001300
href: skysite-tutorial.md
1301-
- name: Skytap
1302-
href: skytap-tutorial.md
1301+
- name: Single Sign-on for Skytap
1302+
href: single-sign-on-for-skytap-tutorial.md
13031303
- name: Skyward Qmlativ
13041304
href: skyward-qmlativ-tutorial.md
13051305
- name: Slack

0 commit comments

Comments
 (0)