次の方法で共有

チュートリアル: KnowledgeOwl と Microsoft Entra のシングル サインオン (SSO) 統合

  • [アーティクル]

このチュートリアルでは、KnowledgeOwl と Microsoft Entra ID を統合する方法について説明します。 KnowledgeOwl と Microsoft Entra ID を統合すると、次のことができます。

  • KnowledgeOwl にアクセスできるユーザーを Microsoft Entra ID で制御する。
  • ユーザーが Microsoft Entra アカウントを使用して KnowledgeOwl に自動的にサインインできるようにする。
  • 1 つの場所でアカウントを管理します。

前提条件

開始するには、次が必要です。

  • Microsoft Entra サブスクリプション。 サブスクリプションがない場合は、無料アカウントを取得できます。
  • KnowledgeOwl でのシングル サインオン (SSO) が有効なサブスクリプション

シナリオの説明

このチュートリアルでは、テスト環境で Microsoft Entra の SSO を構成してテストします。

  • KnowledgeOwl では、SP Initiated SSO と IDP Initiated SSO がサポートされます。
  • KnowledgeOwl では、Just-In-Time ユーザー プロビジョニングがサポートされます。

Microsoft Entra ID への KnowledgeOwl の統合を構成するには、ギャラリーからマネージド SaaS アプリの一覧に KnowledgeOwl を追加する必要があります。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
  3. [ギャラリーから追加する] セクションで、検索ボックスに、「KnowledgeOwl」と入力します。
  4. 結果のパネルから [KnowledgeOwl] を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。

または、Enterprise App Configuration ウィザードを使用することもできます。 このウィザードでは、SSO の構成に加えて、テナントへのアプリケーションの追加、アプリへのユーザーとグループの追加、ロールの割り当てを行うことができます。 Microsoft 365 ウィザードの詳細をご覧ください。

KnowledgeOwl 用に Microsoft Entra SSO を構成してテストする

B.Simon というテスト ユーザーを使用して、KnowledgeOwl との Microsoft Entra SSO を構成してテストします。 SSO を機能させるには、Microsoft Entra ユーザーと、KnowledgeOwl の関連ユーザーとの間にリンク関係を確立する必要があります。

KnowledgeOwl との Microsoft Entra SSO を構成してテストするには、次の手順を実行します。

  1. Microsoft Entra SSO を構成する - ユーザーがこの機能を使用できるようにします。
    1. Microsoft Entra のテスト ユーザーの作成 - B.Simon を使用して Microsoft Entra シングル サインオンをテストします。
    2. Microsoft Entra テスト ユーザーを割り当てる - B.Simon が Microsoft Entra シングル サインオンを使用できるようにします。
  2. KnowledgeOwl の SSO の構成 - アプリケーション側でシングル サインオン設定を構成します。
    1. KnowledgeOwl のテスト ユーザーを作成する - KnowledgeOwl で B.Simon に対応するユーザーを作成し、Microsoft Entra のこのユーザーにリンクさせます。
  3. SSO のテスト - 構成が機能するかどうかを確認します。

Microsoft Entra SSO の構成

次の手順に従って Microsoft Entra SSO を有効にします。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[KnowledgeOwl]>[シングル サインオン] の順に移動します。

  3. [シングル サインオン方式の選択] ページで、 [SAML] を選択します。

  4. [SAML によるシングル サインオンのセットアップ] ページで、 [基本的な SAML 構成] の鉛筆アイコンをクリックして設定を編集します。

    Edit Basic SAML Configuration

  5. [基本的な SAML 構成] セクションで、アプリケーションを IDP 開始モードで構成する場合は、次のフィールドの値を入力します。

    a. [識別子] ボックスに、次のいずれかのパターンを使用して URL を入力します。

    https://app.knowledgeowl.com/sp
https://app.knowledgeowl.com/sp/id/<unique ID>

    b. [応答 URL] ボックスに、次のいずれかのパターンを使用して URL を入力します。

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

  6. アプリケーションを SP 開始モードで構成する場合は、 [追加の URL を設定します] をクリックして次の手順を実行します。

    [サインオン URL] ボックスに、次のいずれかのパターンを使用して URL を入力します。

    https://subdomain.knowledgeowl.com/help/saml-login
https://subdomain.knowledgeowl.com/docs/saml-login
https://subdomain.knowledgeowl.com/home/saml-login
https://privatedomain.com/help/saml-login
https://privatedomain.com/docs/saml-login
https://privatedomain.com/home/saml-login

    注意

    これらは実際の値ではありません。 これらの値を、このチュートリアルの後半で説明する実際の識別子、応答 URL、サインオン URL に更新する必要があります。

  7. KnowledgeOwl アプリケーションは、特定の形式の SAML アサーションを使用するため、カスタム属性マッピングを SAML トークンの属性の構成に追加する必要があります。 次のスクリーンショットには、既定の属性一覧が示されています。

    image

  8. その他に、KnowledgeOwl アプリケーションでは、いくつかの属性が SAML 応答で返されることが想定されています。それらの属性を次に示します。 これらの属性も値が事前に設定されますが、要件に従ってそれらの値を確認することができます。

    名前 ソース属性 名前空間
    ssoid User.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims

  9. [SAML でシングル サインオンをセットアップします] ページの [SAML 署名証明書] セクションで、[証明書 (未加工)] を見つけます。[ダウンロード] を選択して証明書をダウンロードし、お使いのコンピューターに保存します。

    The Certificate download link

  10. [KnowledgeOwl のセットアップ] セクションで、要件に基づいて適切な URL をコピーします。

    Copy configuration URLs

Microsoft Entra テスト ユーザーを作成する

このセクションでは、B.Simon というテスト ユーザーを作成します。

  1. Microsoft Entra 管理センターにユーザー管理者以上でサインインしてください。
  2. [ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
  3. 画面の上部で [新しいユーザー]>[新しいユーザーの作成] を選択します。
  4. [ユーザー] プロパティで、以下の手順を実行します。
    1. "表示名" フィールドに「B.Simon」と入力します。
    2. [ユーザー プリンシパル名] フィールドに「username@companydomain.extension」と入力します。 たとえば、「 B.Simon@contoso.com 」のように入力します。
    3. [パスワードを表示] チェック ボックスをオンにし、 [パスワード] ボックスに表示された値を書き留めます。
    4. [Review + create](レビュー + 作成) を選択します。
  5. [作成] を選択します。

Microsoft Entra テスト ユーザーを割り当てる

このセクションでは、B.Simon に KnowledgeOwl へのアクセスを許可することで、このユーザーがシングル サインオンを使用できるようにします。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[KnowledgeOwl] の順に移動します。
  3. アプリの概要ページで、[ユーザーとグループ] を選択します。
  4. [ユーザーまたはグループの追加] を選択し、 [割り当ての追加] ダイアログで [ユーザーとグループ] を選択します。
    1. [ユーザーとグループ] ダイアログの [ユーザー] の一覧から [B.Simon] を選択し、画面の下部にある [選択] ボタンをクリックします。
    2. ユーザーにロールが割り当てられることが想定される場合は、 [ロールの選択] ドロップダウンからそれを選択できます。 このアプリに対してロールが設定されていない場合は、[既定のアクセス] ロールが選択されていることを確認します。
    3. [割り当ての追加] ダイアログで、 [割り当て] をクリックします。

KnowledgeOwl の SSO の構成

  1. 別の Web ブラウザー ウィンドウで、KnowledgeOwl 企業サイトに管理者としてサインインします。

  2. [Settings](設定) をクリックし、 [SSO] を選択します。

    Screenshot shows SSO selected from the Settings menu.

  3. スクロールした [SAML Settings](SAML 設定) タブで、次の手順を実行します。

    Screenshot shows SAML S S O Integration where you can make the changes described here.

    a. [Enable SAML SSO](SAML SSO を有効にする) をオンにします。

    b. [SP Entity ID](SP エンティティ ID) 値をコピーして、Azure portal の [基本的な SAML 構成] セクションの [識別子 (エンティティ ID)] に貼り付けます。

    c. [SP Login URL](SP ログイン URL) の値をコピーし、Azure portal の [基本的な SAML 構成] セクションの [サインオン URL] および [応答 URL] テキスト ボックスに貼り付けます。

    d. [IdP entityID] テキストボックスに、先ほどコピーした [Microsoft Entra 識別子] の値を貼り付けます。

    e. [IdP ログイン URL] テキスト ボックスに、先ほどコピーしたログイン URL の値を貼り付けます。

    f. [IdP ログアウト URL] テキスト ボックスに、前にコピーしたログアウト URL の値を貼り付けます。

    g. [IdP Certificate](IdP 証明書) の下の [Upload](アップロード) リンクをクリックして、Azure portal からダウンロードした証明書をアップロードします。

    h. ページの下部にある [保存] をクリックします。

    Screenshot shows the Save button.

    i. [SAML Attribute Map](SAML 属性マップ) タブを開いて、次の手順を実行します。

    Screenshot shows Map SAML Attributes where you can make the changes described here.

    • [SSO ID] ボックスに、「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid」と入力します。
    • [Username/Email](ユーザー名/電子メール) ボックスに、「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress」と入力します。
    • [First Name](名) ボックスに、「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname」と入力します。
    • [Last Name](姓) ボックスに、「http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname」と入力します。

    j. ページの下部にある [保存] をクリックします。

    Screenshot shows the Save button1.

KnowledgeOwl のテスト ユーザーの作成

このセクションでは、B.Simon というユーザーを KnowledgeOwl に作成します。 KnowledgeOwl では、Just-In-Time ユーザー プロビジョニングがサポートされており、既定で有効になっています。 このセクションでは、ユーザー側で必要な操作はありません。 KnowledgeOwl にユーザーがまだ存在していない場合は、認証後に新しく作成されます。

注意

ユーザーを手動で作成する必要がある場合は、KnowledgeOwl サポート チームにお問い合わせください。

SSO のテスト

このセクションでは、次のオプションを使用して Microsoft Entra のシングル サインオン構成をテストします。

SP 開始

  • [このアプリケーションをテストします] をクリックすると、ログイン フローを開始できる KnowledgeOwl のサインオン URL にリダイレクトされます。

  • KnowledgeOwl のサインオン URL に直接移動し、そこからログイン フローを開始します。

IDP Initiated

  • Azure portal で [このアプリケーションをテストします] をクリックすると、SSO を設定した KnowledgeOwl アプリケーションに自動的にサインインされます。

また、Microsoft マイ アプリ ポータルを使用して、任意のモードでアプリケーションをテストすることもできます。 マイ アプリ ポータルで [KnowledgeOwl] タイルをクリックすると、SP モードで構成されている場合は、ログイン フローを開始するためのアプリケーション サインオン ページにリダイレクトされます。IDP モードで構成されている場合は、SSO を設定した KnowledgeOwl アプリケーションに自動的にサインインされます。 マイ アプリ ポータルの詳細については、マイ アプリの概要に関するページを参照してください。

次の手順

KnowledgeOwl を構成したら、組織の機密データを流出と侵入からリアルタイムで保護するセッション制御を適用できます。 セッション制御は、条件付きアクセスを拡張したものです。 Microsoft Defender for Cloud Apps でセッション制御を強制する方法をご覧ください。