チュートリアル: Insights で使用する Microsoft Entra ID アプリケーションを作成する

このチュートリアルでは、以下のツールとインサイトを接続するための前提条件の 1 つである、インサイトとともに使用する Microsoft Entra ID アプリケーションの作成について説明します:

  • Azure Data Factory (ADF)
  • Grafana
  • Python

注意

PlayFab Insights Management は、2023 年 12 月 11 日に非推奨になりました。 今後のパフォーマンスとコストを管理するには、Azure Data Explorer (ADX) 接続を使用することをお勧めします。 タイトルがまだ Insights を使用している場合は、実装の詳細についてこの記事を引き続き参照してください。 詳細については、「Insights 非推奨に関するブログ」を参照してください。

前提条件

Microsoft Entra ID アプリケーションの作成

タイトル データベースにリンクする Microsoft Entra ID アプリケーションを作成するには:

  1. Azure Portal にログインします。 Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成します。

  2. ポータルにログイン後、検索バーで [アプリの登録] を検索して選択します。 その後、左上隅の [新規登録] を選択します。

    ADF 新規登録

  3. [アプリケーションの登録] ウィンドウで、登録の名前を入力し、この登録でサポートする必要があるアカウントの種類を選択します。 (判断に迷った場合は、[選択に関する詳細] リンクを選択すると、詳細情報のウィンドウが開きます。)

    ADF 登録アプリ

  4. [登録] を選択します。 新しく登録されたアプリケーションの概要を含むページが表示されます。 アプリケーション (クライアント) IDディレクトリ (テナント) ID をどこかに保存します (これらは後で必要になります)。

  5. 左側のナビゲーション パネルで、[証明書シークレット] - >[新しいクライアント シークレット] を選択します。

    ADF 証明書およびシークレット

  6. シークレットの説明を入力し、有効期間を選択します。

    ADF 追加シークレット

  7. [追加] を選択すると、[クライアント シークレット] の下に新しいシークレットが表示されます。 この秘密鍵をコピーして、安全な場所に保存します。 このページを離れると秘密鍵にアクセスできなくなるので、この操作は今やっておくことが必要不可欠です。

Microsoft Entra ID アプリをタイトル データベースに接続する

Azure アプリをタイトル データベースに接続します。

  1. GameManager の [エクスプローラー] ページまたは Kusto Explorer で、次のコマンドを、自分のタイトル ID とクライアント/テナント ID に置き換えて実行します:

    .add database <titleID> Admin ('aadapp=<app/client ID>;<tenant ID>')

    titleID は大文字と小文字を区別しますので、必ず全角で入力してください。

    エクスプローラー追加データベース

    このコマンドが成功したかどうかは、GameManager[ユーザー] ページに移動することで確認できます。 クライアント/ テナント IDに一致するエントリがあるはずです。

    これにより、PlayFab のゲームで Azure アプリが管理者になることに注意してください。 Azure アプリのアクセス許可を減らしたい場合は、PlayFab で Azure アプリに カスタム ロール を割り当て、Kusto データベースのアクセス許可のみにします。 必要なアクセス許可は、以下のとおりです。

    • エクスプローラーのデータとタブ
    • 分析データ読み取りアクセスで、クエリや簡単な管理コマンドを実行します。
    • 分析データ書き込みアクセスで、テーブルの作成またはドロップ、アイテム保持ポリシーの変更、データの取り込み、パージを行うことができます。

注意

アプリケーションに電子メール アドレスを割り当てたくない場合は、アプリケーションのロールの変更は、[ロール] -> [ロール メンバーの編集] メニューでのみ可能です。

接続性 カスタム ロール

次の手順

Azure アプリを作成し、タイトル データベースにリンクされるようになりました。手順に従って、選択したツールをインサイトに接続します。