次の方法で共有


管理アプリを使用して ALM Accelerator を構成する

ALM Accelerator for Power Platform のコンポーネントは、管理アプリを使用するか手動で構成できます。 この記事では、管理アプリの使用方法を説明し、7 つのセクションで構成されています。

前提条件

ALM Accelerator for Power Platform をインストールする前に、以下の前提条件を満たしていることを確認してください。

  • ALM Accelerator は、Microsoft Dataverse データベースを備えた Power Platform 環境にインストールする必要があります。 ALM Accelerator を使用してソリューションを展開するすべての環境には、Dataverse データベースも必要です。

    メモ

    ALM Accelerator は Dataverse for Teams と互換性がありません。 ALM Accelerator アプリと関連するパイプラインは、すべての環境で Dataverse のフル バージョンを使用していることを前提としています。

    他の CoE スターター キット ソリューションと同じ環境にこの ALM Accelerator をインストールすることをお勧めします。 組織にとって最適な戦略を決定する方法について詳しくは、以下をご覧ください。

  • ALM Accelerator はソース管理と展開 (パイプライン) に Azure DevOps を使用します。 Azure DevOps 組織がない場合は、Azure DevOps サイトで最大 5 ユーザーまで無料でサインアップできます。

  • このセクションの手順を完了するには、Azure、Azure DevOps、 Power Platform で次のユーザーとアクセス許可が必要です。

    • Microsoft Entra グループを作成および表示し、Microsoft Entra ID でアプリ登録を作成し、管理者にアプリ登録への同意を付与する権限を持つ、ライセンス取得済みの Azure ユーザー
    • パイプライン、サービス接続、リポジトリ、および拡張機能を作成および管理する権限を持つ、ライセンス取得済みの Azure DevOps ユーザー
    • アプリケーション ユーザーを作成し、管理権限を付与する権限を持つライセンス付き Power Platform ユーザー
  • ALM Accelerator がインポートされる環境で、次のコネクタを一緒に使用できる必要があります。

  • ALM Accelerator をインストールする環境に Creator Kit をインストールします。

Microsoft Entra アプリ登録を構成する

次の手順は、ALM Accelerator の機能に一般的に適用し、プロジェクトやソリューション固有のものではありません。

ご利用の Microsoft Entra 環境で、アプリ登録を作成する

ALM Accelerator のアプリ登録を作成し、Azure DevOps と Power Apps または Dataverse での操作を実行するために必要な権限をアプリおよび関連するパイプラインに付与します。 これを行う必要があるのは 1 回だけです。

以下の手順では、Dataverse と Azure DevOps の両方の権限を持つ単一のアプリ登録を作成する方法を示します。 ただし、別のアプリ登録を作成して責任を分割することをお勧めします。 アプリの登録戦略を決定する前に、個別のアプリの登録がメンテナンスとセキュリティの両方にどのような影響を与えるかを検討する必要があります

アプリ登録を作成する

  1. Azure portalにサインインします。

  2. Microsoft Entra ID>アプリの登録 を選択します。

  3. + 新規登録 を選択してから、登録に ALMAcceleratorServicePrincipal などの名前を付けます。

  4. 他のすべてのオプションを既定値のままにして、登録 を選択します。

アクセス許可をアプリ登録に追加する

  1. 左側のサイド パネルで、API 資格情報 を選択します。

  2. + アクセス許可の追加を選択します。

  3. Dynamics CRM を選択し、委任された権限user_impersonation を選択します。

  4. アクセス許可の追加を選択して、Dynamics CRM API user_impersonation アクセス許可をアプリ登録に追加します。

  5. + アクセス許可の追加 を再度選択します。

  6. 組織が使用する API タブを選択します。 PowerApps-アドバイザー を検索して選択し、委任されたアクセス許可Analysis.All (管理者の同意は不要) を選択します。

    このアクセス許可は、アプリチェッカー を介して静的分析を実行するために必要です。

  7. アクセス許可の追加 を選択して、PowerApps アドバイザー API Analysis.All のアクセス許可をアプリ登録に追加します。

  8. + アクセス許可の追加 を再度選択します。

  9. Microsoft API タブまたは 組織で使用している API タブのいずれかで、Azure DevOps を選択します。その後委任されたアクセス許可user_impersonation を選択します。

    この権限は、ALM Accelerator アプリのカスタム コネクタを通じて Azure DevOps に接続するために必要となります。

  10. 組織が使用する API タブから Azure DevOps のアクセス許可を追加した場合、この手順の後半に使用するため、アプリケーション (クライアント) ID をコピーします。

    これを DevOps アプリケーション (クライアント) ID と呼ばれますが、この手順の後でコピーした アプリケーション (クライアント) ID とは異なります。

    組織が使用する API タブとアプリケーション (クライアント) IDが強調表示された、API 権限のリクエスト ウィンドウのスクリーンショット。

    組織が使用する API タブに Azure DevOps のアクセス許可が見つからない場合は、次の手順に従って DevOps アプリケーション (クライアント) ID を取得できます:

    1. プライベート ブラウザ ウィンドウを開き、https://dev.azure.com/<your devops organization>/_apis に移動します。
    2. サインイン ページで、URL の client_id パラメータの値をコピーします。

    URL 内の client_id パラメーターが強調表示されている、Azure DevOps 組織のサインインページのスクリーンショット。

  11. アクセス許可の追加を選択して、Azure DevOps user_impersonation アクセス許可をアプリ登録に追加します。

  12. テナント に<管理者の同意を付与する> を選択します

クライアント シークレットとリダイレクト URI を構成する

  1. 左側のナビゲーション パネルで、証明書&シークレット を選択します。

  2. + 新しいクライアント シークレットを選択します。

  3. 有効期限を選択して、追加を選択します。

  4. 後で使用するために、クライアント シークレット をコピーします。 値をコピーできるのはこのときだけです。 ページを離れる前に必ずこれを行ってください。

  5. 左側のサイド パネルで、概要 を選択します。

  6. アプリケーション (クライアント) ID および ディレクトリ (テナント) ID をコピーします。

  7. リダイレクト URI の追加 を選択します。

  8. + プラットフォームの追加 を選択し、Webを選びます。

  9. アプリケーションのリダイレクト URI には https://global.consent.azure-apim.net/redirect と入力します。

    ALM Accelerator アプリをインストールし、Azure DevOps カスタム コネクタを構成した後、この値の変更が必要になる場合があります。 カスタム コネクタに設定されているリダイレクト URI がここで入力したものと異なる場合は、この URI をカスタム コネクタの URI と一致するように変更します。

  10. 構成を選択します。

アプリの登録に Power App Management のアクセス許可を付与します

パイプラインが環境内で必要なアクションを実行できるように、アプリの登録に Power App 管理 権限を付与します。 そのために、Power Apps の管理者権限を持つ対話型ユーザーとして、次の PowerShell コマンドレットを実行します。 アプリ登録を作成した後、このコマンドを 1 回実行するだけで済みます。

重要

次の PowerShell コマンドレットは、アプリ登録に Power Platform 管理者などの昇格された権限を付与します。組織のセキュリティ ポリシーにより、この種の権限が許可されない場合があります。 続行する前に、それらが許可されていることを確認してください。 許可されていない場合、特定の機能は ALM Accelerator パイプラインで動作しません。

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Azure DevOps 拡張機能をインストールする

ALM Accelerator は、Azure DevOps マーケットプレイスで利用可能なサードパーティの拡張機能を含む、いくつかの Azure DevOps の拡張機能を使用します。 各サードパーティ各拡張機能の Web ページとそのソース コードへのリンクは以下の指示をご覧ください。 Marketplace 拡張機能のパブリッシャーを評価する方法について

  1. Azure DevOps にサインインします。

  2. 組織の設定 を選択します。

  3. 全般>拡張機能を選択します。

  4. 次の拡張機能を検索してインストールします:

ソリューションのインポートとアプリの構成

ALM Accelerator キャンバス アプリを Power Platform 環境にインポートし、付属の Azure DevOps 用カスタム コネクタを構成します。

Dataverse に ALM Accelerator をインストールする

  1. GitHub から最新の管理ソリューション ファイルをダウンロードします。 アセット まで下にスクロールし、CenterofExcellenceALMAccelerator_<最新バージョン>_managed.zip を選択します。。

  2. Power Apps にサインインして、ALM Accelerator アプリをホストする環境を選択します。

  3. 左側のサイド パネルで、ソリューション を選択します。

  4. ソリューションのインポート>参照を選択して、その後ダウンロードしたマネージド ソリューションの場所を参照してファイルを選択します。

  5. 次へ を選択して、もう一度 次へ を選択します。

  6. 接続ページで、CDS DevOps 接続を Dataverse に接続する接続を選択または作成します。

    HTTP with Microsoft Entra の接続を作成する場合、両方のパラメーターに Microsoft Graph を使用します。

  7. インポート を選択します。

DevOps カスタム コネクタの構成

  1. データ>カスタム コネクタ>CustomAzureDevOps を選択します。

  2. 編集 を選択します。

  3. セキュリティ タブで 編集 を選択し、次の値を設定します。

    名前 価値
    認証の種類 OAuth 2.0
    ID プロバイダー Microsoft Entra ID
    クライアント ID アプリ登録を作成した時にコピーしたアプリケーション (クライアント) ID
    クライアント シークレット アプリ登録を作成した 時にコピーした アプリケーション (クライアント) シークレットの値
    テナント ID 既定値を 一般 のままにします
    リソース URL アプリ登録に権限を追加する ときにコピーした DevOps アプリケーション (クライアント) ID
  4. コネクタの更新 を選択します。

  5. セキュリティ ページの リダイレクト URLhttps://global.consent.azure-apim.net/redirect であることを確認します。

    利用可能でない場合は、URL をコピーします。 前に作成したアプリ登録に戻り、そこにあるリダイレクト URI をコピーした URL に置き換えます。

カスタム コネクタのテスト

  1. テスト メニューを開きます。

  2. 新しい接続 を選択してから、プロンプトに従って接続を作成します。

  3. Power Apps で、環境を選択し、Dataverse>カスタム コネクタ>CustomAzureDevOps の順に選択します。

  4. 編集 を選択して テスト ページに移動し、GetOrganizations 操作を検索します。

  5. 操作のテストを選択します。

  6. 返された応答ステータス200 であり、応答本文が Azure DevOps 組織の JSON 表現であることを確認してください。

    カスタム Azure DevOps コネクタのテスト用セキュリティ設定のスクリーンショット。

ALM Accelerator で使用する最初の Azure DevOps プロジェクトをセットアップする

付属のウィザードを使用して、ALM Accelerator を使用して Power Platform ソリューションを展開する Azure DevOps プロジェクトを設定します。 既存の空のプロジェクトを構成するか作成できます。

  1. ALM Accelerator 管理アプリを開きます。

  2. 左側のパネルで、Azure DevOps グループでプロジェクトをクリックします。

  3. リリース タグの更新を求められた場合、Okay を選択します。

  4. 一覧から Azure DevOps 組織を選択してください。

  5. プロジェクト リスト で、新規 を選択します。

  6. プロジェクト ウィザード を選択します。

  7. プロジェクト ステップで、プロジェクトの名前を入力します。 必要に応じて、説明を入力し、プレビュー機能を有効にします。

  8. 次へを選択します。

  9. パイプライン テンプレート ステップで、次へ を選択して、テンプレートを新しいプロジェクトにインストールします。

    アプリは、プロジェクトの新しいリポジトリにパイプライン テンプレートをインストールします。 または、既にインストールされているプロジェクトからテンプレートを使用するようにプロジェクトを構成することもできます。

  10. サービス接続 ステップで、サービス接続を作成する環境を選択します。

    複数の環境を選択して、それらすべてのサービス接続を同時に作成できます。 環境に異なるアプリ登録を使用するには、各アプリ登録ごとにサービス接続を個々に作成する必要があります。

  11. アプリ登録のためにサービス接続を構成したら、追加 をクリックします。

  12. すべてのサービス接続を構成したら、次へ を選択します。

  13. 汎用パイプライン ステップで、次へ を選択して、パイプラインと変数グループを作成し、ALM Accelerator 機能に必要なプロジェクトの Azure DevOps のアクセス許可を設定します。

利用している Dataverse 環境で、アプリ ユーザーを作成する

環境内にアプリケーション ユーザーを作成し、パイプラインが Dataverse に接続できるようにします。 これは、ALM Accelerator を使用して展開する予定の各環境で実行します。

  1. Power Platform 管理センター にサインインします。

  2. 開発環境を選択してから、設定 を選択します。

  3. ユーザー + アクセス許可>アプリケーション ユーザーを選択します。

  4. + 新しいアプリ ユーザー を選択します。

  5. + アプリに追加 を選択して、アプリの登録時に作成したアプリを選択し、追加 を選択します。

  6. 部署 を選択する。

  7. セキュリティ ロール の右側にある鉛筆アイコンを選択し、アプリ ユーザーのセキュリティ ロールを選択します。

    このアプリ ユーザーにシステム管理者セキュリティ ロール権限を付与して、ユーザーが各環境で必要な機能を実行できるようにすることをお勧めします。

  8. 作成 を選択します。

検証、テスト、および実稼働環境で今ステップを繰り返します。

作成者を設定して ALM Accelerator アプリを使用する

詳細情報