O'Reilly 学習プラットフォームを構成し、Microsoft Entra ID を使った自動ユーザー プロビジョニングに対応させる

この記事では、自動ユーザー プロビジョニングを構成するために O'Reilly 学習プラットフォームと Microsoft Entra ID の両方で実行する必要がある手順について説明します。 構成すると、Microsoft Entra ID は、Microsoft Entra プロビジョニング サービスを使用して ユーザーを O'Reilly ラーニング プラットフォームに自動的に プロビジョニングおよびプロビジョニング解除します。 このサービスの機能、しくみ、よく寄せられる質問の重要な詳細については、「 Microsoft Entra ID を使用して SaaS アプリケーションへのユーザー プロビジョニングとプロビジョニング解除を自動化する」を参照してください。

サポートされている機能

[前提条件]

この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。

• Microsoft Entra テナント
• アプリケーション管理者、クラウド アプリケーション管理者、またはアプリケーション所有者のいずれかのロール。
• 管理者権限を持つ O'Reilly 学習プラットフォームのユーザー アカウント。
• O'Reilly 学習プラットフォームのシングル サインオン (SSO) 対応サブスクリプション。

手順 1: プロビジョニングデプロイメントを計画する

• プロビジョニング サービスのしくみについて説明します。
• プロビジョニングの対象範囲にいるユーザーを決定します。
• Microsoft Entra ID と O'Reilly 学習プラットフォームの間でマップするデータを決定します。

手順 2: Microsoft Entra ID でのプロビジョニングをサポートするように O'Reilly 学習プラットフォームを構成する

Microsoft Entra ID でのプロビジョニングをサポートするように O'Reilly 学習プラットフォームの構成を開始する前に、O'Reilly 管理コンソール内で SCIM API トークンを生成する必要があります。

1. O'Reilly アカウントにログインして、O'Reilly 管理コンソールに移動します。
2. ログインしたら、上部のナビゲーションで [管理者 ] を選択し、[ 統合] を選択します。
3. [API トークン] セクションまで下にスクロールします。 [API トークン] で [ トークンの作成 ] を選択し、 SCIM API を選択します。 次に、トークンに名前と有効期限を指定し、[続行] を選択します。 API キーがポップアップ メッセージで通知され、そのコピーを安全な場所に保存するように求められます。 キーのコピーを保存したら、チェックボックスをオンにして[続行]を選択します。
4. 手順 5 で O'Reilly SCIM API トークンを使用します。

手順 3: Microsoft Entra アプリケーション ギャラリーから O'Reilly 学習プラットフォームを追加する

Microsoft Entra アプリケーション ギャラリーから O'Reilly 学習プラットフォームを追加して、O'Reilly 学習プラットフォームへのプロビジョニングの管理を開始します。 SSO 用に O'Reilly ラーニング プラットフォームを以前に設定している場合は、同じアプリケーションを使用できます。 ただし、最初に統合をテストするときは、別のアプリを作成することをお勧めします。 ギャラリーからのアプリケーションの追加の詳細については、 こちらをご覧ください。

手順 4: プロビジョニングのスコープに含まれるユーザーを定義する

Microsoft Entra プロビジョニング サービスを使用すると、アプリケーションへの割り当てに基づいて、またはユーザーまたはグループの属性に基づいてプロビジョニングされるユーザーをスコープできます。 割り当てに基づいてアプリにプロビジョニングされるユーザーのスコープを設定する場合は、 手順を使用してユーザーとグループをアプリケーションに割り当てることができます。 ユーザーまたはグループの属性のみに基づいてプロビジョニングされるユーザーのスコープを設定する場合は、 スコープ フィルターを使用できます。

• 小規模から始めます。 すべてのユーザーとグループにロールアウトする前に、少数のユーザーとグループでテストします。 プロビジョニングのスコープが割り当てられたユーザーとグループに設定されている場合は、1 つまたは 2 つのユーザーまたはグループをアプリに割り当てることで、これを制御できます。 スコープがすべてのユーザーとグループに設定されている場合は、 属性ベースのスコープ フィルターを指定できます。

• 追加のロールが必要な場合は、 アプリケーション マニフェストを更新 して新しいロールを追加できます。

手順 5: O'Reilly 学習プラットフォームへの自動ユーザー プロビジョニングを構成する

このセクションでは、Microsoft Entra プロビジョニング サービスが、Microsoft Entra ID でのユーザー割り当てに基づいて、O'Reilly 学習プラットフォームでのユーザーの作成、更新、無効化を行うように構成する手順について説明します。

Microsoft Entra ID で O'Reilly 学習プラットフォームの自動ユーザー プロビジョニングを構成するには:

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

2. Entra ID>Enterprise アプリに移動する

   

3. アプリケーションの一覧で[ O'Reilly learning platform]\(O'Reilly 学習プラットフォーム\) を選択します。

   

4. [プロビジョニング] タブ を 選択します。

   

5. [プロビジョニング モード] を[自動] に設定します。

   

6. [ 管理者資格情報 ] セクションで、O'Reilly ラーニング プラットフォームのテナント URL ( https://api.oreilly.com/api/scim/v2) と、手順 2 で生成したシークレット トークンを入力します。 [ テスト接続] を選択して、Microsoft Entra ID が O'Reilly 学習プラットフォームに接続できることを確認します。 接続に失敗した場合は、トークンが正しいことを再確認するか、 O'Reilly プラットフォーム統合チームに問い合わせてください 。

   

7. [ 通知メール ] フィールドに、プロビジョニング エラー通知を受け取るユーザーのメール アドレスを入力し、[ エラーが発生したときに電子メール通知を送信 する] チェック ボックスをオンにします。

   

8. [保存] を選択します。

9. [マッピング] セクション で 、[ Microsoft Entra ユーザーを O'Reilly 学習プラットフォームに同期する] を選択します。

10. [属性マッピング] セクションで、Microsoft Entra ID から O'Reilly 学習プラットフォームに同期されるユーザー 属性 を確認します。 [照合プロパティ] として選択されている属性は、更新操作のために O'Reilly 学習プラットフォームのユーザー アカウントとの照合に使用されます。 一致するターゲット属性を変更する場合は、O'Reilly 学習プラットフォーム API がその属性に基づくユーザーのフィルター処理をサポートしていることを確認する必要があります。 [ 保存 ] ボタンを選択して変更をコミットします。

    特性	タイプ	フィルター処理でサポートされます	O'Reilly 学習プラットフォームで必須
    ユーザー名	糸	✓	✓
    活動中	ブール値
    emails[type eq "仕事"].value	糸		✓
    名前.名	糸		✓
    名前.姓	糸		✓
    エクスターナルID	糸		✓

11. スコープ フィルターを構成するには、スコープ フィルターに関する記事に記載されている次の手順 を参照してください。

12. O'Reilly 学習プラットフォームに対して Microsoft Entra プロビジョニング サービスを有効にするには、[設定] セクションで [プロビジョニングの状態] を [オン] に変更します。

    プロビジョニング状態がオンになっているスクリーンショット。

13. [設定] セクションの [スコープ] で目的の値を選択して、O'Reilly 学習プラットフォームにプロビジョニングするユーザーを定義します。

    

14. プロビジョニングの準備ができたら、[ 保存] を選択します。

    

この操作により、[設定] セクションの [スコープ] で定義されているすべてのユーザーの初期同期サイクルが開始されます。 最初のサイクルは、Microsoft Entra プロビジョニング サービスが実行されている限り、約 40 分ごとに発生する後続のサイクルよりも実行に時間がかかります。

手順 6: デプロイを監視する

プロビジョニングを構成したら、次のリソースを使用してデプロイを監視します。

1. プロビジョニング ログを使用して、どのユーザーが正常にプロビジョニングされたか、または正常にプロビジョニングされなかったかを判断する
2. 進行状況バーを確認して、プロビジョニング サイクルの状態と完了までの近さを確認します
3. プロビジョニング構成が異常な状態にあると思われる場合、アプリケーションは検疫に入ります。 検疫状態の詳細については、 アプリケーションプロビジョニングの検疫状態 に関する記事を参照してください。

その他のリソース

• Enterprise Apps のユーザー アカウント プロビジョニングの管理
• Microsoft Entra ID を使用したアプリケーション アクセスとシングル サインオンとは

関連コンテンツ

• ログを確認し、プロビジョニング アクティビティに関するレポートを取得する方法について説明します