Dataverse プラグイン用に Power Platform マネージド ID バージョン 1 を設定する

バージョン 1 では、証明書 の共通名 (CN) からフェデレーション ID 資格情報 (FIC) サブジェクト識別子がビルドされます。

Important

バージョン 2 は推奨されるバージョンであり、任意の証明書名で動作します。 この記事は、既存のバージョン 1 のセットアップを維持する場合にのみ使用します。 新しいプラグインについては、「 Power Platform マネージド ID の設定 (バージョン 2)」を参照してください。 既存のプラグインをバージョン 2 に移行するには、「 バージョン 2 へのアップグレード」を参照してください。

証明書 CN に ASCII 以外の文字 (AADSTS70050) またはコンマ (AADSTS700213) が含まれている場合、バージョン 1 は失敗します。 いずれかのエラーが発生した場合は、バージョン 2 に移動します。

Prerequisites

バージョン 2 と同じです。 「前提条件」を参照してください。

マネージド ID の設定 (バージョン 1)

手順は、FIC サブジェクト識別子の形式 (手順 3) とマネージド ID レコードのバージョン ( 手順 4) を除き、バージョン 2 と同じです。

手順 1: アプリ登録またはユーザー割り当てマネージド ID を作成する

バージョン 2 からの変更はありません。 手順 1 を参照してください。

手順 2: プラグインをビルド、署名、登録する

バージョン 2 からの変更はありません。 手順 2を確認してください。

手順 3: フェデレーション ID 資格情報を構成する

Azure ポータルで、アプリまたはユーザー割り当てマネージド ID (UAMI) を開き、証明書とシークレット>認証された資格情報>資格情報の追加に移動し、[その他の発行者] を選択します。 次に、次のように入力します。

  • 発行者 — https://login.microsoftonline.com/{tenantID}/v2.0

  • 型 - 明示的なサブジェクト識別子

  • サブジェクト識別子 — 証明書の種類の形式を使用します。

    • 信頼された発行者証明書 (運用):

      /eid1/c/pub/t/{encodedTenantId}/a/qzXoWDkuqUa3l6zM5mM0Rw/n/plugin/e/{environmentId}/i/{issuer}/s/{certificateSubject}

    • 自己署名証明書 (開発のみ):

      /eid1/c/pub/t/{encodedTenantId}/a/qzXoWDkuqUa3l6zM5mM0Rw/n/plugin/e/{environmentId}/h/{hash}

手順 4: Dataverse でマネージド ID レコードを作成する

バージョン 1 では、 version を 1 に設定します。

{
  "applicationid": "<<appId>>",
  "managedidentityid": "<<anyGuid>>",
  "credentialsource": 2,
  "subjectscope": 1,
  "tenantid": "<<tenantId>>",
  "version": 1
}

手順 5: Azure リソースへのアクセスを許可する

アプリケーションまたはユーザー割り当てマネージド ID に、必要なAzure リソース (Azure Key Vaultなど) へのアクセス権を付与します。

手順 6: 統合を検証する

プラグインをトリガーし、トークンを取得し、別の資格情報なしでAzure リソースに到達します。

よく寄せられる質問

AADSTS700213を解決するにはどうすればよいですか?

CN にコンマが含まれている場合は、 バージョン 2 に移動します。

AADSTS70050を解決するにはどうすればよいですか?

バージョン 2 に移行すると、ASCII 専用のサブジェクト識別子が生成されます。

  • Last updated on