この環境変数リファレンスでは、Power Platform Playwright サンプルのすべての構成設定について説明します。 ローカル開発の場合は、 packages/e2e-tests/.envでこれらの変数を設定します。 CI/CD で、パイプライン シークレットまたは変数として設定します。 パイプライン固有の手順については、 CI/CD 統合に関する記事を参照してください。
認証変数
これらの変数は、Power Platform サービスに対するテスト フレームワークの認証方法を制御します。
| Variable | 必須 | 説明 |
|---|---|---|
MS_AUTH_EMAIL |
はい | テスト ユーザー アカウントの電子メール アドレス |
MS_AUTH_CREDENTIAL_TYPE |
はい | 認証方法: password または certificate |
MS_USER_PASSWORD |
もし credential_type=password |
テスト ユーザーのパスワード |
MS_AUTH_CREDENTIAL_PROVIDER |
もし credential_type=certificate |
証明書のソース: local-file または azure-keyvault |
MS_AUTH_LOCAL_FILE_PATH |
もし provider=local-file |
.pfx証明書ファイルへの相対パス |
MS_AUTH_CERTIFICATE_PASSWORD |
いいえ |
.pfx証明書のパスワード (保護されている場合) |
Azure Key Vault変数
MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvaultする場合は必須:
| Variable | 説明 |
|---|---|
AZURE_KEYVAULT_URL |
Key Vault URL (例: https://<vault-name>.vault.azure.net/) |
AZURE_CERTIFICATE_NAME |
Key Vaultに格納されている証明書の名前 |
AZURE_TENANT_ID |
Microsoft Entra テナント ID |
AZURE_CLIENT_ID |
(省略可能)フェデレーション ID のサービス プリンシパル クライアント ID |
アプリの URL 変数
これらの変数は、テスト対象のアプリの URL を指定します。
| Variable | 必須 | 説明 |
|---|---|---|
CANVAS_APP_URL |
キャンバス テストの場合 | キャンバス アプリの完全な再生モード URL (以下を含む) ?tenantId=<id> |
MODEL_DRIVEN_APP_URL |
モデル駆動型アプリ テストの場合 | モデル駆動型アプリの完全な URL (/main.aspx?appid=<id>) |
CUSTOM_PAGE_NAME |
カスタム ページ テストの場合 | カスタム ページ サイトマップ アイテムの表示名 (例: AccountsCustomPage |
キャンバス アプリの URL をビルドする
ツールキットの buildCanvasAppUrlFromEnv() を使用して、必要に応じて個々のパーツから URL を構築します。
import { buildCanvasAppUrlFromEnv } from 'power-platform-playwright-toolkit';
const url = buildCanvasAppUrlFromEnv();
// Reads CANVAS_APP_URL from environment
または、 .envで明示的に設定します。
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
モデル駆動型アプリの URL を取得する
次の手順に従って、モデル駆動型アプリの正しい URL を見つけます。
- 再生モードでモデル駆動型アプリを開きます。
- ブラウザーのアドレス バーから URL をコピーします。
- セッション固有の
appid=<guid>後にクエリ パラメーターを削除します。
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-guid>
ストレージ状態変数
ツールキットは、 MS_AUTH_EMAILからこれらの変数を計算します。 直接設定しないでください。
| Path | 説明 |
|---|---|
.playwright-ms-auth/state-<email>.json |
Power Apps認証状態 (キャンバス/Gen UX テスト) |
.playwright-ms-auth/state-mda-<email>.json |
Dynamics 365認証状態 (MDA テスト) |
ストレージ状態ディレクトリをオーバーライドします。
MS_AUTH_STORAGE_DIR=../../.auth
CI/CD フラグ
このフラグを使用して、継続的インテグレーション環境のテスト動作を調整します。
| Variable | デフォルト | 説明 |
|---|---|---|
CI |
false |
、、およびより厳密なタイムアウトを有効にするには、CI でに設定します |
プレイライトは自動的に CI 読み取ります。
.envで設定する必要はありません。パイプライン環境では規則によって設定されます。
サンプル .env ファイル
ローカル .env ファイルの開始点として、次の例を使用します。
# Authentication
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=password
MS_USER_PASSWORD=<your-password>
# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/e/default-<tenant-id>/a/<app-id>?tenantId=<tenant-id>
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/main.aspx?appid=<app-id>
CUSTOM_PAGE_NAME=AccountsCustomPage
証明書認証の場合:
# Authentication (certificate)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=local-file
MS_AUTH_LOCAL_FILE_PATH=../../cert/testuser.pfx
MS_AUTH_CERTIFICATE_PASSWORD=<pfx-password>
# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...
Azure Key Vaultの場合:
# Authentication (Key Vault)
MS_AUTH_EMAIL=testuser@contoso.com
MS_AUTH_CREDENTIAL_TYPE=certificate
MS_AUTH_CREDENTIAL_PROVIDER=azure-keyvault
AZURE_KEYVAULT_URL=https://mykeyvault.vault.azure.net/
AZURE_CERTIFICATE_NAME=playwright-test-cert
AZURE_TENANT_ID=<tenant-guid>
# App URLs
CANVAS_APP_URL=https://apps.powerapps.com/play/...
MODEL_DRIVEN_APP_URL=https://<org>.crm.dynamics.com/...
セキュリティに関するメモ
資格情報とセッション データをセキュリティで保護するには、次のプラクティスに従います。
-
.envファイルをソース管理にコミットしないでください。 リポジトリ内の.gitignoreは、それらを除外します。 - 状態ファイル
.playwright-ms-auth/コミットしないでください。 セッション トークンが含まれています。 - CI/CD では、チェックインされた YAML ではなく、パイプラインのシークレット ストアを介してすべてのシークレットを設定します。