チュートリアル: Microsoft Entra と TOPdesk - Public の統合
- [アーティクル]
-
-
このチュートリアルでは、TOPdesk - Public を Microsoft Entra ID と統合する方法について説明します。 TOPdesk - Public を Microsoft Entra ID と統合すると、次のことができます。
- TOPdesk - Public にアクセスできるユーザーを Microsoft Entra ID で制御する。
- ユーザーが自分の Microsoft Entra アカウントを使って TOPdesk - Public に自動的にサインインできるようにする。
- 1 つの場所でアカウントを管理します。
開始するには、次が必要です。
- Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
- TOPdesk - Public でのシングル サインオン (SSO) が有効なサブスクリプション。
このチュートリアルでは、テスト環境で Microsoft Entra シングル サインオンを構成してテストします。
- TOPdesk - Public では、SP Initiated SSO がサポートされます。
ギャラリーからの TOPdesk - Public の追加
Microsoft Entra ID への TOPdesk - Public の統合を構成するには、ギャラリーから管理対象 SaaS アプリの一覧に TOPdesk - Public を追加する必要があります。
- クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
- [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
- [ギャラリーから追加する] セクションで、検索ボックスに「TOPdesk - Public」と入力します。
- 結果のパネルから TOPdesk - Public を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。
または、Enterprise App Configuration ウィザードを使用することもできます。 このウィザードでは、SSO の構成に加えて、テナントへのアプリケーションの追加、アプリへのユーザーとグループの追加、ロールの割り当てを行うことができます。 Microsoft 365 ウィザードの詳細をご覧ください。
B.Simon というテスト ユーザーを使って、TOPdesk - Public に対する Microsoft Entra SSO を構成してテストします。 SSO が機能するには、Microsoft Entra ユーザーと TOPdesk - Public の関連ユーザーの間にリンク関係を確立する必要があります。
TOPdesk - Public に対して Microsoft Entra SSO を構成してテストするには、次の手順を実行します。
- Microsoft Entra SSO を構成する - ユーザーがこの機能を使用できるようにします。
- Microsoft Entra のテスト ユーザーの作成 - B.Simon を使用して Microsoft Entra シングル サインオンをテストします。
- Microsoft Entra テスト ユーザーを割り当てる - B.Simon が Microsoft Entra シングル サインオンを使用できるようにします。
- TOPdesk - Public の SSO の構成 - アプリケーション側でシングル サインオン設定を構成します。
- TOPdesk - Public テスト ユーザーを作成する - TOPdesk - Public で B.Simon に対応するユーザーを作成し、Microsoft Entra のこのユーザーにリンクさせます。
- SSO のテスト - 構成が機能するかどうかを確認します。
次の手順に従って Microsoft Entra SSO を有効にします。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
[ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[TOPdesk - Public]>[シングル サインオン] の順に移動します。
[シングル サインオン方式の選択] ページで、 [SAML] を選択します。
[SAML によるシングル サインオンのセットアップ] ページで、 [基本的な SAML 構成] の鉛筆アイコンをクリックして設定を編集します。
[基本的な SAML 構成] セクションで、サービス プロバイダー メタデータ ファイルがある場合は、次の手順に従います。
注意
チュートリアルで後述する [Configure TOPdesk - Public Single Sign-On](TOPdesk - Public シングル サインオンの構成) セクションからサービス プロバイダー メタデータ ファイルを取得します。
a. [メタデータ ファイルをアップロードします] をクリックします。
b. フォルダー ロゴをクリックしてメタデータ ファイルを選択し、 [アップロード] をクリックします。
c. メタデータ ファイルが正常にアップロードされると、識別子と応答 URL の値が、[基本的な SAML 構成] セクションに自動的に設定されます。
d. [サインオン URL] ボックスに、https://<companyname>.topdesk.net
という形式で URL を入力します。
e. [Identifier URL](識別子 URL) ボックスに、TOPdesk 構成から取得できる TOPdesk メタデータ URL を入力します。 これには次のパターンを使用する必要があります: https://<companyname>.topdesk.net/saml-metadata/<identifier>
f. [応答 URL] ボックスに、https://<companyname>.topdesk.net/tas/public/login/verify
のパターンを使用して URL を入力します。
注意
[識別子] と [応答 URL] の値が自動的に入力されない場合は、手動で入力する必要があります。 [識別子] については前述のパターンに従い、チュートリアルで後述する [Configure TOPdesk - Public Single Sign-On](TOPdesk - Public シングル サインオンの構成) セクションから [応答 URL] の値を取得します。 この [サインオン URL] の値は実際のものとは異なるので、実際のサインオン URL で更新する必要があります。 この値を取得するには、TOPdesk - Public クライアント サポート チームに問い合わせてください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。
[SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、 [ダウンロード] をクリックして、要件のとおりに指定したオプションからフェデレーション メタデータ XML をダウンロードして、お使いのコンピューターに保存します。
[Set up TOPdesk - Public](TOPdesk - Public のセットアップ) セクションで、要件に従って適切な URL をコピーします。
Microsoft Entra テスト ユーザーを作成する
このセクションでは、B.Simon というテスト ユーザーを作成します。
- Microsoft Entra 管理センターにユーザー管理者以上でサインインしてください。
- [ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
- 画面の上部で [新しいユーザー]>[新しいユーザーの作成] を選択します。
- [ユーザー] プロパティで、以下の手順を実行します。
- "表示名" フィールドに「
B.Simon
」と入力します。
- [ユーザー プリンシパル名] フィールドに「username@companydomain.extension」と入力します。 たとえば、「
B.Simon@contoso.com
」のように入力します。
- [パスワードを表示] チェック ボックスをオンにし、 [パスワード] ボックスに表示された値を書き留めます。
- [Review + create](レビュー + 作成) を選択します。
- [作成] を選択します。
Microsoft Entra テスト ユーザーを割り当てる
このセクションでは、B.Simon に TOPdesk - Public へのアクセスを許可することで、シングル サインオンを使用できるようにします。
- クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
- [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[TOPdesk - Public] の順に移動します。
- アプリの概要ページで、[ユーザーとグループ] を選択します。
- [ユーザーまたはグループの追加] を選択し、 [割り当ての追加] ダイアログで [ユーザーとグループ] を選択します。
- [ユーザーとグループ] ダイアログの [ユーザー] の一覧から [B.Simon] を選択し、画面の下部にある [選択] ボタンをクリックします。
- ユーザーにロールが割り当てられることが想定される場合は、 [ロールの選択] ドロップダウンからそれを選択できます。 このアプリに対してロールが設定されていない場合は、[既定のアクセス] ロールが選択されていることを確認します。
- [割り当ての追加] ダイアログで、 [割り当て] をクリックします。
TOPdesk - Public 会社サイトに管理者としてサインインします。
[TOPdesk] メニューで、[設定] をクリックします。
[ログイン設定] をクリックします。
[ログイン設定] メニューを展開し、[全般] をクリックします。
[SAML ログイン] 構成セクションの [公開] セクションで、次の手順を実行します。
a. [ダウンロード] をクリックして公開メタデータ ファイルをダウンロードし、コンピューターのローカルに保存します。
b. ダウンロードしたメタデータ ファイルを開いて、AssertionConsumerService ノードを探します。
c. [AssertionConsumerService] の値をコピーし、[基本的な SAML 構成] セクションの [応答 URL] テキストボックスにこの値を貼り付けます。
証明書ファイルを作成するには、次の手順を実行します。
a. Azure Portal からダウンロードしたメタデータ ファイルを開きます。
b. RoleDescriptor ノードを展開します。ここには fed:ApplicationServiceType の xsi:type があります。
c. X509Certificate ノードの値をコピーします。
d. コピーした X509Certificate の値をコンピューターのローカルのファイルに保存します。
[公開] セクションで、[追加] をクリックします。
[SAML 構成アシスタント] ダイアログ ページで、次の手順を実行します。
a. Azure Portal からダウンロードしたメタデータ ファイルをアップロードするには、[Federation Metadata] で [Browse] をクリックします。
b. 証明書ファイルをアップロードするには、[証明書 (RSA)] の下の [参照] をクリックします。
c. TOPdesk サポート チームから取得したロゴ ファイルをアップロードするには、[ロゴ アイコン] の下の [参照] をクリックします。
d. [User name attribute] ボックスに、「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
」と入力します。
e. [表示名] テキストボックスに、構成の名前を入力します。
f. [保存] をクリックします。
TOPdesk - Public のテスト ユーザーの作成
Microsoft Entra ユーザーが TOPdesk - Public にサインインできるようにするには、そのユーザーを TOPdesk - Public にプロビジョニングする必要があります。 TOPdesk - Public の場合、プロビジョニングは手動で行います。
TOPdesk - Public 企業サイトに管理者としてサインオンします。
上部のメニューで、[TOPdesk]>[New]>[Support Files]>[Person] の順にクリックします。
[New Person] ダイアログで、次の手順を実行します。
a. [General] タブをクリックします。
b. [Surname] ボックスに、ユーザーの姓を入力します (この例では Simon)。
c. アカウントの [サイト] を選択します。
d. [保存] をクリックします。
注意
他の TOPdesk - Public ユーザー アカウントの作成ツールまたは TOPdesk - Public から提供されている API を使って、Microsoft Entra ユーザー アカウントをプロビジョニングできます。
このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。
[このアプリケーションをテストする] をクリックすると、ログイン フローを開始できる TOPdesk - Public のサインオン URL にリダイレクトされます。
TOPdesk - Public のサインオン URL に直接移動し、そこからログイン フローを開始します。
Microsoft マイ アプリを使用することができます。 マイ アプリで [TOPdesk - Public] タイルをクリックすると、TOPdesk - Public のサインオン URL にリダイレクトされます。 マイ アプリの詳細については、マイ アプリの概要に関するページを参照してください。
TOPdesk - Public を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用できます。 セッション制御は、条件付きアクセスを拡張したものです。 Microsoft Defender for Cloud Apps でセッション制御を強制する方法をご覧ください。