教學課程:Azure Active Directory 與 Pingboard 整合Tutorial: Azure Active Directory integration with Pingboard

在本教學課程中,您會了解如何整合 Pingboard 與 Azure Active Directory (Azure AD)。In this tutorial, you learn how to integrate Pingboard with Azure Active Directory (Azure AD). Pingboard 與 Azure AD 整合提供下列優點:Integrating Pingboard with Azure AD provides you with the following benefits:

  • 您可以在 Azure AD 中控制可存取 Pingboard 的人員。You can control in Azure AD who has access to Pingboard.
  • 您可以讓使用者使用他們的 Azure AD 帳戶自動登入 Pingboard (單一登入)。You can enable your users to be automatically signed-in to Pingboard (Single Sign-On) with their Azure AD accounts.
  • 您可以在 Azure 入口網站中集中管理您的帳戶。You can manage your accounts in one central location - the Azure portal.

若您想了解 SaaS app 與 Azure AD 整合的更多詳細資訊,請參閱 什麼是搭配 Azure Active Directory 的應用程式存取和單一登入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. 如果您沒有 Azure 訂用帳戶,請在開始之前先建立免費帳戶If you don't have an Azure subscription, create a free account before you begin.

PrerequisitesPrerequisites

若要設定 Pingboard 與 Azure AD 的整合,您需要下列項目:To configure Azure AD integration with Pingboard, you need the following items:

  • Azure AD 訂用帳戶。An Azure AD subscription. 如果您沒有 Azure AD 環境,您可以在這裡取得一個月的試用帳戶If you don't have an Azure AD environment, you can get one-month trial here
  • 已啟用 Pingboard 單一登入功能的訂用帳戶Pingboard single sign-on enabled subscription

案例描述Scenario description

在本教學課程中,您會在測試環境中設定和測試 Azure AD 單一登入。In this tutorial, you configure and test Azure AD single sign-on in a test environment.

若要設定將 Pingboard 整合到 Azure AD 中,您需要從資源庫將 Pingboard 新增到受控 SaaS 應用程式清單。To configure the integration of Pingboard into Azure AD, you need to add Pingboard from the gallery to your list of managed SaaS apps.

若要從資源庫新增 Pingboard,請執行下列步驟:To add Pingboard from the gallery, perform the following steps:

  1. Azure 入口網站 的左方瀏覽窗格中,按一下 [Azure Active Directory] 圖示。In the Azure portal, on the left navigation panel, click Azure Active Directory icon.

    Azure Active Directory 按鈕

  2. 瀏覽至 [企業應用程式] ,然後選取 [所有應用程式] 選項。Navigate to Enterprise Applications and then select the All Applications option.

    企業應用程式刀鋒視窗

  3. 若要新增新的應用程式,請按一下對話方塊頂端的 [新增應用程式] 按鈕。To add new application, click New application button on the top of dialog.

    新增應用程式按鈕

  4. 在搜尋方塊中,輸入 Pingboard 並從結果面板中選取 [Pingboard] ,然後按一下 [新增] 按鈕以新增應用程式。In the search box, type Pingboard, select Pingboard from result panel then click Add button to add the application.

    結果清單中的 Pingboard

設定和測試 Azure AD 單一登入Configure and test Azure AD single sign-on

在本節中,您會以名為 Britta Simon 的測試使用者身分,使用 Pingboard 設定及測試 Azure AD 單一登入。In this section, you configure and test Azure AD single sign-on with Pingboard based on a test user called Britta Simon. 若要讓單一登入能夠運作,必須建立 Azure AD 使用者與 Pingboard 中相關使用者之間的連結關聯性。For single sign-on to work, a link relationship between an Azure AD user and the related user in Pingboard needs to be established.

若要設定及測試與 Pingboard 搭配運作的 Azure AD 單一登入,您需要完成下列建置組塊:To configure and test Azure AD single sign-on with Pingboard, you need to complete the following building blocks:

  1. 設定 Azure AD 單一登入 - 讓您的使用者能夠使用此功能。Configure Azure AD Single Sign-On - to enable your users to use this feature.
  2. 設定 Pingboard 單一登入 - 在應用程式端設定單一登入設定。Configure Pingboard Single Sign-On - to configure the Single Sign-On settings on application side.
  3. 建立 Azure AD 測試使用者 - 使用 Britta Simon 測試 Azure AD 單一登入。Create an Azure AD test user - to test Azure AD single sign-on with Britta Simon.
  4. 指派 Azure AD 測試使用者 - 讓 Britta Simon 能夠使用 Azure AD 單一登入。Assign the Azure AD test user - to enable Britta Simon to use Azure AD single sign-on.
  5. 建立 Pingboard 測試使用者 - 在 Pingboard 中建立 Britta Simon 的對應項目,且該項目必須與 Azure AD 中代表使用者的項目連結。Create Pingboard test user - to have a counterpart of Britta Simon in Pingboard that is linked to the Azure AD representation of user.
  6. 測試單一登入 ,驗證組態是否能運作。Test single sign-on - to verify whether the configuration works.

設定 Azure AD 單一登入Configure Azure AD single sign-on

在本節中,您會在 Azure 入口網站中啟用 Azure AD 單一登入。In this section, you enable Azure AD single sign-on in the Azure portal.

若要使用 Pingboard 設定 Azure AD 單一登入,請執行下列步驟:To configure Azure AD single sign-on with Pingboard, perform the following steps:

  1. Azure 入口網站的 [Pingboard] 應用程式整合頁面上,選取 [單一登入] 。In the Azure portal, on the Pingboard application integration page, select Single sign-on.

    設定單一登入連結

  2. 在 [選取單一登入方法] 對話方塊中,選取 [SAML/WS-Fed] 模式以啟用單一登入。On the Select a Single sign-on method dialog, select SAML/WS-Fed mode to enable single sign-on.

    單一登入選取模式

  3. 在 [以 SAML 設定單一登入] 頁面上,按一下 [編輯] 圖示以開啟 [基本 SAML 設定] 對話方塊。 On the Set up Single Sign-On with SAML page, click Edit icon to open Basic SAML Configuration dialog.

    編輯基本 SAML 組態

  4. 在 [基本 SAML 設定] 區段上,如果您想要以 IDP 起始模式設定應用程式,請執行下列步驟:On the Basic SAML Configuration section, if you wish to configure the application in IDP initiated mode, perform the following steps:

    顯示 [基本 SAML 設定] 的螢幕擷取畫面,其中已反白顯示 [識別碼] 和 [回覆 U R L] 文字方塊,並已選取 [儲存] 按鈕。

    a.a. 在 [識別碼] 文字方塊中,鍵入 URL:http://app.pingboard.com/spIn the Identifier text box, type a URL: http://app.pingboard.com/sp

    b.b. 在 [回覆 URL] 文字方塊中,使用下列模式來輸入 URL:https://<entity-id>.pingboard.com/auth/saml/consumeIn the Reply URL text box, type a URL using the following pattern: https://<entity-id>.pingboard.com/auth/saml/consume

  5. 如果您想要以 SP 起始模式設定應用程式,請按一下 [設定其他 URL],然後執行下列步驟:Click Set additional URLs and perform the following step if you wish to configure the application in SP initiated mode:

    Pingboard 網域與 URL 單一登入資訊

    在 [登入 URL] 文字方塊中,以下列模式輸入 URL︰https://<sub-domain>.pingboard.com/sign_inIn the Sign-on URL text box, type a URL using the following pattern: https://<sub-domain>.pingboard.com/sign_in

    注意

    這些都不是真正的值。These values are not real. 請使用實際的回覆 URL 與登入 URL 更新這些值。Update these values with the actual Reply URL and Sign-on URL. 請連絡 Pingboard 用戶端支援小組以取得這些值。Contact Pingboard Client support team to get these values. 您也可以參考 Azure 入口網站中 基本 SAML 組態 區段所示的模式。You can also refer to the patterns shown in the Basic SAML Configuration section in the Azure portal.

  6. 在 [以 SAML 設定單一登入] 頁面的 [SAML 簽署憑證] 區段中按一下 [下載],以依據您的需求從指定選項下載 同盟中繼資料 XML,並儲存在您的電腦上。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.

    憑證下載連結

  7. 在 [設定 Pingboard] 區段上,依據您的需求複製適當的 URL。On the Set up Pingboard section, copy the appropriate URL(s) as per your requirement.

    複製組態 URL

    a.a. 登入 URLLogin URL

    b.b. Azure AD 識別碼Azure AD Identifier

    c.c. 登出 URLLogout URL

設定 Pingboard 單一登入Configure Pingboard Single Sign-On

  1. 若要在 Pingboard 端上設定 SSO,請開啟新的瀏覽器視窗,然後登入 Pingboard 帳戶。To configure SSO on Pingboard side, open a new browser window and sign in to your Pingboard Account. 您必須是 Pingboard 管理員才能設定單一登入。You must be a Pingboard admin to set up single sign on.

  2. 從頂端功能表中選取 [應用程式] > [整合] From the top menu,, select Apps > Integrations

    設定單一登入

  3. 在 [整合] 頁面上,尋找 [Azure Active Directory] 圖格,然後按一下它。On the Integrations page, find the "Azure Active Directory" tile, and click it.

    Pingboard 單一登入整合

  4. 在接下來的強制回應中按一下 [設定] In the modal that follows click "Configure"

    Pingboard 設定按鈕

  5. 在下列頁面上,您會注意到「Azure SSO 整合已啟用」。On the following page, you notice that "Azure SSO Integration is enabled". 在記事本中開啟下載的中繼資料 XML 檔案,並且將內容貼上到 IDP 中繼資料Open the downloaded Metadata XML file in a notepad and paste the content in IDP Metadata.

    Pingboard SSO 組態畫面

  6. 系統會驗證檔案,如果所有項目都正確,則會立即啟用單一登入。The file is validated, and if everything is correct, single sign-on will now be enabled.

建立 Azure AD 測試使用者Create an Azure AD test user

本節的目標是要在 Azure 入口網站中建立一個名為 Britta Simon 的測試使用者。The objective of this section is to create a test user in the Azure portal called Britta Simon.

  1. 在 Azure 入口網站的左窗格中,依序選取 [Azure Active Directory] 、[使用者] 和 [所有使用者] 。In the Azure portal, in the left pane, select Azure Active Directory, select Users, and then select All users.

    [使用者和群組] 與 [所有使用者] 連結

  2. 在畫面頂端選取 [新增使用者] 。Select New user at the top of the screen.

    [新增使用者] 按鈕

  3. 在 [使用者] 屬性中,執行下列步驟。In the User properties, perform the following steps.

    [使用者] 對話方塊

    a.a. 在 [名稱] 欄位中,輸入 BrittaSimonIn the Name field enter BrittaSimon.

    b.b. 在 [使用者名稱] 欄位中,輸入 brittasimon@yourcompanydomain.extension。In the User name field type brittasimon@yourcompanydomain.extension. 例如, BrittaSimon@contoso.comFor example, BrittaSimon@contoso.com

    c.c. 選取 [顯示密碼] 核取方塊,然後記下 [密碼] 方塊中顯示的值。Select Show password check box, and then write down the value that's displayed in the Password box.

    d.d. 按一下頁面底部的 [新增] 。Click Create.

指派 Azure AD 測試使用者Assign the Azure AD test user

在本節中,您會將 Pingboard 的存取權授與 Britta Simon,讓她能夠使用 Azure 單一登入。In this section, you enable Britta Simon to use Azure single sign-on by granting access to Pingboard.

  1. 在 Azure 入口網站中,依序選取 [企業應用程式] 、[所有應用程式] 及 [Pingboard] 。In the Azure portal, select Enterprise Applications, select All applications, then select Pingboard.

    企業應用程式刀鋒視窗

  2. 在應用程式清單中,選取 [Pingboard] 。In the applications list, select Pingboard.

    應用程式清單中的 Pingboard 連結

  3. 在左側功能表中,選取 [使用者和群組] 。In the menu on the left, select Users and groups.

    [使用者和群組] 連結

  4. 按一下 [新增使用者] 按鈕,然後在 [新增指派] 對話方塊中,選取 [使用者和群組]。Click the Add user button, then select Users and groups in the Add Assignment dialog.

    [新增指派] 窗格

  5. 在 [使用者和群組] 對話方塊的 [使用者] 清單中,選取 [Britta Simon] ,然後按一下畫面底部的 [選取] 按鈕。In the Users and groups dialog select Britta Simon in the Users list, then click the Select button at the bottom of the screen.

  6. 如果您預期使用 SAML 判斷提示中的任何角色值,請在 [選取角色] 對話方塊的清單中選取適當使用者角色,然後按一下畫面底部的 [選取] 按鈕。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.

  7. 在 [新增指派] 對話方塊中,按一下 [指派] 按鈕。In the Add Assignment dialog click the Assign button.

建立 Pingboard 測試使用者Create Pingboard test user

本節目標是在 Pingboard 中建立名為 Britta Simon 的使用者。The objective of this section is to create a user called Britta Simon in Pingboard. Pingboard 支援自動使用者佈建,該功能預設為啟用。Pingboard supports automatic user provisioning, which is by default enabled. 您可以在這裡找到關於如何設定自動使用者佈建的更多詳細資料。You can find more details here on how to configure automatic user provisioning.

如果您需要手動建立使用者,請執行下列步驟:If you need to create user manually, perform following steps:

  1. 以系統管理員身分登入您的 Pingboard 公司網站。Sign in to your Pingboard company site as an administrator.

  2. 按一下 [目錄] 頁面上的 [新增員工] 按鈕。Click “Add Employee” button on Directory page.

    新增員工

  3. 在 [新增員工] 對話方塊頁面上,執行下列步驟:On the “Add Employee” dialog page, perform the following steps:

    邀請人員

    a.a. 在 [全名] 文字方塊中,輸入使用者的全名,例如 Britta SimonIn the Full Name textbox, type the full name of user like Britta Simon.

    b.b. 在 [電子郵件] 文字方塊中,輸入使用者的電子郵件地址,例如 brittasimon@contoso.comIn the Email textbox, type the email address of user like brittasimon@contoso.com.

    c.c. 在 [職稱] 文字方塊中,輸入 Britta Simon 的職稱。In the Job Title textbox, type the job title of Britta Simon.

    d.d. 在 [位置] 下拉式清單中,選取 Britta Simon 的位置。In the Location dropdown, select the location of Britta Simon.

    e.e. 按一下 [新增] 。Click Add.

  4. 確認畫面會顯示,供確認新增使用者。A confirmation screen comes up to confirm the addition of user.

    確認

    注意

    Azure Active Directory 帳戶的持有者會收到一封電子郵件,並依照連結在啟用其帳戶前進行確認。The Azure Active Directory account holder receives an email and follows a link to confirm their account before it becomes active.

測試單一登入Test single sign-on

在本節中,您會使用存取面板來測試您的 Azure AD 單一登入設定。In this section, you test your Azure AD single sign-on configuration using the Access Panel.

當您在存取面板中按一下 [Pingboard] 圖格時,應該會自動登入您設定 SSO 的 Pingboard。When you click the Pingboard tile in the Access Panel, you should be automatically signed in to the Pingboard for which you set up SSO. 如需「存取面板」的詳細資訊,請參閱存取面板簡介For more information about the Access Panel, see Introduction to the Access Panel.

其他資源Additional Resources