次の方法で共有

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

  • [アーティクル]

このチュートリアルでは、Qiita Team を Microsoft Entra ID と統合する方法について学習します。 Qiita Team を Microsoft Entra ID と統合すると、次のことができるようになります:

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

前提条件

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

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

シナリオの説明

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

  • Qiita Team では、IDP によって開始される SSO がサポートされます。

  • Qiita Team では、Just In Time ユーザー プロビジョニングがサポートされます。

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

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

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

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

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

Qiita Team に対して Microsoft Entra SSO を構成してテストするには、次の手順を実行します:

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

Microsoft Entra SSO の構成

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

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

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

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

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

    Edit Basic SAML Configuration

  5. [基本的な SAML 構成] セクションで、次の手順を実行します。

    a. [識別子] ボックスに、https://<SUBDOMAIN>.qiita.com/saml/metadata の形式で URL を入力します。

    b. [応答 URL] ボックスに、https://<SUBDOMAIN>.qiita.com/saml/consume のパターンを使用して URL を入力します

    注意

    これらは実際の値ではありません。 実際の識別子と応答 URL でこれらの値を更新します。 これらの値を取得するには、Qiita Team クライアント サポート チームに問い合わせてください。 [基本的な SAML 構成] セクションに示されているパターンを参照することもできます。

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

    image

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

    名前 ソース属性
    User.FirstName User.surname
    User.LastName User.givenname

  8. [SAML によるシングル サインオンのセットアップ] ページの [SAML 署名証明書] セクションで、 [フェデレーション メタデータ XML] を探して [ダウンロード] を選択し、証明書をダウンロードして、お使いのコンピューターに保存します。

    The Certificate download link

  9. [Set up Qiita Team](Qiita Team のセットアップ) セクションで、要件に基づいて適切な 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 に Qiita Team へのアクセスを許可することで、このユーザーがシングル サインオンを使用できるようにします。

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

Qiita Team SSO の構成

Qiita Team 側でシングル サインオンを構成するには、ダウンロードしたフェデレーション メタデータ XML とアプリケーションの構成からコピーした適切な URL を Qiita Team サポート チームに送信する必要があります。 サポート チームはこれを設定して、SAML SSO 接続が両方の側で正しく設定されるようにします。

Qiita Team テスト ユーザーの作成

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

SSO のテスト

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

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

  • Microsoft マイ アプリを使用することができます。 マイ アプリで [Qiita Team] タイルをクリックします。これにより、SSO を設定した Qiita Team に自動的にサインインします。 マイ アプリの詳細については、マイ アプリの概要に関するページを参照してください。

次のステップ

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