GitHub Actions を使用してカスタムポリシーをデプロイする

2025-05-01

重要

2025 年 5 月 1 日より、Azure AD B2C は新規のお客様向けに購入できなくなります。詳細については、FAQ を参照してください。

GitHub Actions を使用すると、GitHub リポジトリにカスタムの継続的インテグレーション (CI) ワークフローと継続的デプロイ (CD) ワークフローを直接作成できます。この記事では、GitHub Actions を使用して Azure Active Directory B2C (Azure AD B2C) カスタムポリシーのデプロイを自動化する方法について説明します。

カスタムポリシーのデプロイプロセスを自動化するには、 GitHub アクションを使用して Azure AD B2C カスタムポリシーをデプロイします。この GitHub アクションは、 Azure AD B2C コミュニティによって開発されました。

このアクションにより、 Microsoft Graph API を使用して Azure AD B2C カスタムポリシーが Azure AD B2C テナントにデプロイされます。ポリシーがまだテナントに存在しない場合は、作成されます。それ以外の場合は、置き換えられます。

重要

Azure Pipelines を使用して Azure AD B2C カスタムポリシーを管理する場合、現在、Microsoft Graph API エンドポイントで使用できる/beta操作が使用されています。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。詳細については、 Microsoft Graph REST API ベータエンドポイントリファレンスを参照してください。

[前提条件]

「Active Directory B2C でのカスタムポリシーの概要」の手順を完了してください。
GitHub リポジトリを作成していない場合は、作成します。

カスタムポリシーフォルダーを選択する

GitHub リポジトリには、すべての Azure AD B2C ポリシーファイルとその他の資産を含めることができます。リポジトリのルートディレクトリで、カスタムポリシーを含む既存のフォルダーを作成または選択します。

たとえば、ポリシーという名前のフォルダー を選択します。 Azure AD B2C カスタムポリシーファイルを policies フォルダーに追加します。次に、変更を コミット します。

変更を プッシュ しないでください。これは、デプロイワークフローを設定した後で行います。

Microsoft Graph アプリケーションを登録する

GitHub アクションが Microsoft Graph API と対話できるようにするには、Azure AD B2C テナントにアプリケーション登録を作成します。まだ行っていない場合は、 Microsoft Graph アプリケーションを登録します。

GitHub アクションで Microsoft Graph のデータにアクセスするには、登録されているアプリケーションに関連するアプリケーションのアクセス許可を付与します。アプリ登録の API アクセス許可内で、>>Policy.ReadWrite.TrustFramework アクセス許可を付与します。

GitHub で暗号化されたシークレットを作成する

GitHub シークレットは、組織、リポジトリ、またはリポジトリ環境で作成する暗号化された環境変数です。この手順では、 MS Graph アプリケーションの登録手順で先ほど登録したアプリケーションのアプリケーションシークレットを格納します。

Azure AD B2C カスタムポリシーをデプロイするための GitHub アクションでは、シークレットを使用して、Microsoft Graph API との対話に使用されるアクセストークンを取得します。詳細については、リポジトリの暗号化されたシークレットの作成を参照してください。

GitHub シークレットを作成するには、次の手順に従います。

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [設定] を選択します。
左側のサイドバーで、[シークレット] を選択 します。
新しいリポジトリシークレット を選択してください。
[名前] に「ClientSecret」と入力します。
[値] には、前に作成したアプリケーションシークレットを入力します。
[Add secret](シークレットの追加) を選択します。

GitHub ワークフローを作成する

GitHub ワークフローは、リポジトリに追加する自動化された手順です。ワークフローは 1 つ以上のジョブで構成され、イベントによってスケジュールまたはトリガーできます。この手順では、カスタムポリシーをデプロイするワークフローを作成します。

ワークフローを作成するには、次の手順に従います。

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [ アクション] を選択します。

$[GitHub Actions]$GitHub アクション$ タブを示すスクリーンショット$
以前にワークフローを構成していない場合は、 自分でワークフローを設定するを選択します。それ以外の場合は、[ 新しいワークフロー] を選択します。

GitHub では、main.yml フォルダーに .github/workflows という名前のワークフローファイルを作成できます。このファイルには、Azure AD B2C 環境やデプロイするカスタムポリシーなど、ワークフローに関する情報が含まれています。 GitHub Web エディターで、次の YAML コードを追加します。

on: push

env:
  clientId: 00001111-aaaa-2222-bbbb-3333cccc4444
  tenant: your-tenant.onmicrosoft.com

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2

    - name: 'Upload TrustFrameworkBase Policy'
      uses: azure-ad-b2c/deploy-trustframework-policy@v3
      with:
        folder: "./Policies"
        files: "TrustFrameworkBase.xml,TrustFrameworkLocalization.xml,TrustFrameworkExtensions.xml,SignUpOrSignin.xml"
        tenant: ${{ env.tenant }}
        clientId: ${{ env.clientId }}
        clientSecret: ${{ secrets.clientSecret }}

YAML ファイルの次のプロパティを更新します。

セクション	名前	価値
`env`	`clientId`	MS Graph アプリケーションの登録手順で登録したアプリケーションのアプリケーション (クライアント) ID。
`env`	`tenant`	Azure AD B2C のテナント名（たとえば、contoso.onmicrosoft.com）。
`with`	`folder`	カスタムポリシーファイルが格納されているフォルダー (たとえば、 `./Policies`)。
`with`	`files`	展開するポリシーファイルのコンマ区切りの一覧 (たとえば、 `TrustFrameworkBase.xml,TrustFrameworkLocalization.xml,TrustFrameworkExtensions.xml,SignUpOrSignin.xml`)。

重要

エージェントを実行してポリシーファイルをアップロードするときは、正しい順序でアップロードされていることを確認します。

TrustFrameworkBase.xml
TrustFrameworkLocalization.xml
TrustFrameworkExtensions.xml
SignUpOrSignin.xml
ProfileEdit.xml
PasswordReset.xml

[ コミットの開始] を選択します。
コミットメッセージフィールドの下に、コミットを現在のブランチに追加するか、新しいブランチに追加するかを指定します。 [ 新しいファイルのコミット] または [新しいファイルの提案 ] を選択して pull request を作成します。

ワークフローのテスト

作成したワークフローをテストするには、カスタムポリシーの変更を プッシュ します。ジョブの実行が開始されると、実行の進行状況の視覚化グラフが表示され、GitHub で各ステップのアクティビティが表示されます。

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [ アクション] を選択します。
左側のサイドバーで、作成したワークフローを選択します。
[ ワークフロー実行] で、表示する実行の名前を選択します。
ジョブ またはビジュアライゼーショングラフで、表示するジョブを選択します。
各ステップの結果を表示します。次のスクリーンショットは、[ カスタムポリシーのアップロード] ステップログを示しています。

省略可能: ワークフローをスケジュールする

作成したワークフローは、プッシュイベントによってトリガーされます。必要に応じて、別のイベントを選択して、プル要求などのワークフローをトリガーできます。

POSIX cron 構文を使用して、特定の UTC 時刻に実行するようにワークフローをスケジュールすることもできます。スケジュールイベントを使用すると、スケジュールされた時刻にワークフローをトリガーできます。詳細については、「スケジュールされたイベント」を参照してください。

次の例では、毎日 5:30 および 17:30 UTC にワークフローをトリガーします。

on:
  schedule:
    # * is a special character in YAML so you have to quote this string
    - cron:  '30 5,17 * * *'

ワークフローを編集するには:

GitHub で、リポジトリのメインページに移動します。
リポジトリ名の下にある [ アクション] を選択します。
左側のサイドバーで、作成したワークフローを選択します。
[ ワークフロー実行] で、表示する実行の名前を選択します。
メニューから 3 つのドット ...を選択し、[ ワークフローファイルの表示] を選択します。
GitHub Web エディターで、[編集] を選択 します。
on: pushを上記の例に変更します。
変更をコミットします。

次のステップ

ワークフローをトリガーするイベントを構成する方法について説明します

次の方法で共有

GitHub Actions を使用してカスタム ポリシーをデプロイする