Merge pull request #2573 from MicrosoftDocs/FromPrivateRepo

From private repo

Author: v-alje

.openpublishing.redirection.json

@@ -3095,11 +3095,6 @@
             "redirect_url": "/azure/mobile-engagement/mobile-engagement-overview",
             "redirect_document_id": false
         },
-        {
-            "source_path": "articles/operations-management-suite/oms-security-web-baseline.md",
-            "redirect_url": "https://www.microsoft.com/cloud-platform/security-and-compliance",
-            "redirect_document_id": false
-        },
         {
             "source_path": "articles/remoteapp/index.md",
             "redirect_url": "/azure/remoteapp/remoteapp-whatis",

articles/active-directory/active-directory-saas-perceptionunitedstates-tutorial.md

@@ -0,0 +1,267 @@
+---
+title: 'Tutorial: Azure Active Directory integration with Perception United States (Non-UltiPro) | Microsoft Docs'
+description: Learn how to configure single sign-on between Azure Active Directory and Perception United States (Non-UltiPro).
+services: active-directory
+documentationCenter: na
+author: jeevansd
+manager: femila
+ms.reviewer: joflore
+
+ms.assetid: b4a8f026-cb5f-41eb-9680-68eddc33565e
+ms.service: active-directory
+ms.workload: identity
+ms.tgt_pltfrm: na
+ms.devlang: na
+ms.topic: article
+ms.date: 07/20/2017
+ms.author: jeedes
+
+---
+# Tutorial: Azure Active Directory integration with Perception United States (Non-UltiPro)
+
+In this tutorial, you learn how to integrate Perception United States (Non-UltiPro) with Azure Active Directory (Azure AD).
+
+Integrating Perception United States (Non-UltiPro) with Azure AD provides you with the following benefits:
+
+- You can control in Azure AD who has access to Perception United States (Non-UltiPro).
+- You can enable your users to automatically get signed-on to Perception United States (Non-UltiPro) (Single Sign-On) with their Azure AD accounts.
+- You can manage your accounts in one central location - the Azure portal.
+
+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](active-directory-appssoaccess-whatis.md).
+
+## Prerequisites
+
+To configure Azure AD integration with Perception United States (Non-UltiPro), you need the following items:
+
+- An Azure AD subscription
+- A Perception United States (Non-UltiPro) single sign-on enabled subscription
+
+> [!NOTE]
+> To test the steps in this tutorial, we do not recommend using a production environment.
+
+To test the steps in this tutorial, you should follow these recommendations:
+
+- Do not use your production environment, unless it is necessary.
+- If you don't have an Azure AD trial environment, you can [get a one-month trial](https://azure.microsoft.com/pricing/free-trial/).
+
+## Scenario description
+In this tutorial, you test Azure AD single sign-on in a test environment. 
+The scenario outlined in this tutorial consists of two main building blocks:
+
+1. Adding Perception United States (Non-UltiPro) from the gallery
+2. Configuring and testing Azure AD single sign-on
+
+## Adding Perception United States (Non-UltiPro) from the gallery
+To configure the integration of Perception United States (Non-UltiPro) into Azure AD, you need to add Perception United States (Non-UltiPro) from the gallery to your list of managed SaaS apps.
+
+**To add Perception United States (Non-UltiPro) from the gallery, perform the following steps:**
+
+1. In the **[Azure portal](https://portal.azure.com)**, on the left navigation panel, click **Azure Active Directory** icon. 
+
+	![The Azure Active Directory button][1]
+
+2. Navigate to **Enterprise applications**. Then go to **All applications**.
+
+	![The Enterprise applications blade][2]
+	
+3. To add new application, click **New application** button on the top of dialog.
+
+	![The New application button][3]
+
+4. In the search box, type **Perception United States (Non-UltiPro)**, select **Perception United States (Non-UltiPro)** from result panel then click **Add** button to add the application.
+
+	![Perception United States (Non-UltiPro) in the results list](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_addfromgallery.png)
+
+## Configure and test Azure AD single sign-on
+
+In this section, you configure and test Azure AD single sign-on with Perception United States (Non-UltiPro) based on a test user called "Britta Simon".
+
+For single sign-on to work, Azure AD needs to know what the counterpart user in Perception United States (Non-UltiPro) is to a user in Azure AD. In other words, a link relationship between an Azure AD user and the related user in Perception United States (Non-UltiPro) needs to be established.
+
+In Perception United States (Non-UltiPro), assign the value of the **user name** in Azure AD as the value of the **Username** to establish the link relationship.
+
+To configure and test Azure AD single sign-on with Perception United States (Non-UltiPro), you need to complete the following building blocks:
+
+1. **[Configure Azure AD Single Sign-On](#configure-azure-ad-single-sign-on)** - to enable your users to use this feature.
+2. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with Britta Simon.
+3. **[Create a Perception United States (Non-UltiPro) test user](#create-a-perception-united-states-non-ultipro-test-user)** - to have a counterpart of Britta Simon in Perception United States (Non-UltiPro) that is linked to the Azure AD representation of user.
+4. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable Britta Simon to use Azure AD single sign-on.
+5. **[Test single sign-on](#test-single-sign-on)** - to verify whether the configuration works.
+
+### Configure Azure AD single sign-on
+
+In this section, you enable Azure AD single sign-on in the Azure portal and configure single sign-on in your Perception United States (Non-UltiPro) application.
+
+**To configure Azure AD single sign-on with Perception United States (Non-UltiPro), perform the following steps:**
+
+1. In the Azure portal, on the **Perception United States (Non-UltiPro)** application integration page, click **Single sign-on**.
+
+	![Configure single sign-on link][4]
+
+2. On the **Single sign-on** dialog, select **Mode** as	**SAML-based Sign-on** to enable single sign-on.
+ 
+	![Single sign-on dialog box](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_samlbase.png)
+
+3. On the **Perception United States (Non-UltiPro) Domain and URLs** section, perform the following steps:
+
+	![Perception United States (Non-UltiPro) Domain and URLs single sign-on information](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_url.png)
+
+    a. In the **Identifier** textbox, type the URL: `https://perception.kanjoya.com/sp`
+
+	b. In the **Reply URL** textbox, type a URL using the following pattern: `https://perception.kanjoya.com/sso?idp=<entity_id>`
+
+	> [!NOTE] 
+	> The value is not real. You will update the value with the actual Reply URL, which is explained later in the tutorial.
+ 
+4. On the **SAML Signing Certificate** section, click **Metadata XML** and then save the metadata file on your computer.
+
+	![The Certificate download link](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_certificate.png) 
+
+5. Click **Save** button.
+
+	![Configure Single Sign-On Save button](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_400.png)
+
+6. On the **Perception United States (Non-UltiPro) Configuration** section, click **Configure Perception United States (Non-UltiPro)** to open **Configure sign-on** window. Copy the **SAML Entity ID** from the **Quick Reference section.**
+
+	a. The **Perception United States (Non-UltiPro)** application requires the **SAML Entity ID** value, which you have copied, to be uri encoded. To get the uri encoded value, use the following link:**http://www.url-encode-decode.com/**.
+
+	b. After getting the uri encoded value combine it with the **Reply URL** as mentioned below-
+
+	`https://perception.kanjoya.com/sso?idp=<URI encooded entity_id>`
+	
+	c. Paste the above value in the **Reply URL** textbox in **Perception United States (Non-UltiPro) Domain and URLs** section.
+
+	![Perception United States (Non-UltiPro) Configuration](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_configure.png) 
+
+7. In another browser window, sign on to your Perception United States (Non-UltiPro) company site as an administrator.
+
+8. In the main toolbar, click **Account Settings**.
+
+    ![Perception United States (Non-UltiPro) user](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_user.png)
+
+9. On the **Account Settings** page, perform the following steps:
+
+	![Perception United States (Non-UltiPro) user](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_account.png)
+
+	a. In the **Company Name** textbox, type the name of the **Company**.
+	
+	b. In the **Account Name** textbox, type the name of the **Account**.
+
+	c. In **Default Reply-To Email** text box, type the valid **Email**.
+
+	d. Select **SSO Identity Provider** as **SAML 2.0**.
+
+10. On the **SSO Configuration** page, perform the following steps:
+
+    ![Perception United States (Non-UltiPro) SSOConfig](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_ssoconfig.png)
+
+	a. Select **SAML NameID Type** as **EMAIL**.
+
+	b. In the **SSO Configuration Name** textbox, type the name of your **Configuration**.
+	
+	c. In **Identity Provider Name** textbox, paste the value of **SAML Entity ID**, which you have copied from Azure portal. 
+
+	d. In **SAML Domain textbox**, enter the domain like **@contoso.com**.
+
+	e. Click on **Upload Again** to upload the **Metadata XML** file.
+
+	f. Click **Update**.
+
+
+> [!TIP]
+> You can now read a concise version of these instructions inside the [Azure portal](https://portal.azure.com), while you are setting up the app!  After adding this app from the **Active Directory > Enterprise Applications** section, simply click the **Single Sign-On** tab and access the embedded documentation through the **Configuration** section at the bottom. You can read more about the embedded documentation feature here: [Azure AD embedded documentation]( https://go.microsoft.com/fwlink/?linkid=845985)
+
+### Create an Azure AD test user
+
+The objective of this section is to create a test user in the Azure portal called Britta Simon.
+
+   ![Create an Azure AD test user][100]
+
+**To create a test user in Azure AD, perform the following steps:**
+
+1. In the Azure portal, in the left pane, click the **Azure Active Directory** button.
+
+    ![The Azure Active Directory button](./media/active-directory-saas-perceptionunitedstates-tutorial/create_aaduser_01.png)
+
+2. To display the list of users, go to **Users and groups**, and then click **All users**.
+
+    ![The "Users and groups" and "All users" links](./media/active-directory-saas-perceptionunitedstates-tutorial/create_aaduser_02.png)
+
+3. To open the **User** dialog box, click **Add** at the top of the **All Users** dialog box.
+
+    ![The Add button](./media/active-directory-saas-perceptionunitedstates-tutorial/create_aaduser_03.png)
+
+4. In the **User** dialog box, perform the following steps:
+
+    ![The User dialog box](./media/active-directory-saas-perceptionunitedstates-tutorial/create_aaduser_04.png)
+
+    a. In the **Name** box, type **BrittaSimon**.
+
+    b. In the **User name** box, type the email address of user Britta Simon.
+
+    c. Select the **Show Password** check box, and then write down the value that's displayed in the **Password** box.
+
+    d. Click **Create**.
+  
+### Create a Perception United States (Non-UltiPro) test user
+
+In this section, you create a user called Britta Simon in Perception United States (Non-UltiPro). Work with [Perception United States (Non-UltiPro) support team](http://www.ultimatesoftware.com/Contact/ContactUs) to add the users in the Perception United States (Non-UltiPro) platform.
+
+### Assign the Azure AD test user
+
+In this section, you enable Britta Simon to use Azure single sign-on by granting access to Perception United States (Non-UltiPro).
+
+![Assign the user role][200] 
+
+**To assign Britta Simon to Perception United States (Non-UltiPro), perform the following steps:**
+
+1. In the Azure portal, open the applications view, and then navigate to the directory view and go to **Enterprise applications** then click **All applications**.
+
+	![Assign User][201] 
+
+2. In the applications list, select **Perception United States (Non-UltiPro)**.
+
+	![The Perception United States (Non-UltiPro) link in the Applications list](./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_perceptionunitedstates_app.png)  
+
+3. In the menu on the left, click **Users and groups**.
+
+	![The "Users and groups" link][202]
+
+4. Click **Add** button. Then select **Users and groups** on **Add Assignment** dialog.
+
+	![The Add Assignment pane][203]
+
+5. On **Users and groups** dialog, select **Britta Simon** in the Users list.
+
+6. Click **Select** button on **Users and groups** dialog.
+
+7. Click **Assign** button on **Add Assignment** dialog.
+	
+### Test single sign-on
+
+In this section, you test your Azure AD single sign-on configuration using the Access Panel.
+
+When you click the Perception United States (Non-UltiPro) tile in the Access Panel, you should get automatically signed-on to your Perception United States (Non-UltiPro) application.
+For more information about the Access Panel, see [Introduction to the Access Panel](active-directory-saas-access-panel-introduction.md). 
+
+## Additional resources
+
+* [List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory](active-directory-saas-tutorial-list.md)
+* [What is application access and single sign-on with Azure Active Directory?](active-directory-appssoaccess-whatis.md)
+
+
+
+<!--Image references-->
+
+[1]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_01.png
+[2]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_02.png
+[3]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_03.png
+[4]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_04.png
+
+[100]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_100.png
+
+[200]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_200.png
+[201]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_201.png
+[202]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_202.png
+[203]: ./media/active-directory-saas-perceptionunitedstates-tutorial/tutorial_general_203.png
+