カスタムドメインのSAML移行

​

事前準備

• MCD が有効になっている Enterprise プランのテナント。
• Auth0 テナントに設定された、検証済みの 2 つのカスタムドメイン:
  1. 既存のレガシードメイン (プロキシ用)
  2. 新しいターゲットドメイン (アプリケーション用)
• Terraform CLI と Node.js/npm がインストールされていること。
• カスタムドメインをホストしているドメインにアクセスできる Cloudflare アカウント。

​

仕組み

​

セットアップと設定

1. 移行リポジトリをクローンします。

git clone https://github.com/abbaspour/auth0-mcd-federation-migration.git
cd auth0-mcd-federation-migration

2. 依存関係をインストールします：

npm install

3. 必要な資格情報とドメイン情報を含む terraform.auto.tfvars ファイルを tf ディレクトリに作成します:

# Auth0 サービスプロバイダー (SP) 変数
auth0_domain = "your-sp-tenant.auth0.com"
auth0_existing_custom_domain = "oldfed.example.com"
auth0_new_custom_domain = "id.example2.com"
auth0_tf_client_id = "your-sp-client-id"
auth0_tf_client_secret = "your-sp-client-secret"

# Auth0 IDプロバイダー (IDP) 変数
auth0_idp_domain = "your-idp-tenant.auth0.com"
auth0_idp_tf_client_id = "your-idp-client-id"
auth0_idp_tf_client_secret = "your-idp-client-secret"

# Cloudflare 変数
cloudflare_api_key = "your-cloudflare-api-key"
cloudflare_email = "your-cloudflare-email"
cloudflare_zone_id = "your-cloudflare-zone-id"

4. Terraform を初期化し、適用します:

cd tf
terraform init
terraform apply

​

Cloudflare Worker をデプロイする

1. Cloudflare プロキシをデプロイします。

cd ..
npx wrangler deploy

2. ワーカーは、Terraform の出力結果から必要な環境変数 (AUTH0_EDGE_LOCATION や NEW_SP_DOMAIN など) を自動的に受け取ります。

​

SAML 接続パラメーターを一時的に更新する

1. read:connections および update:connections スコープを持つ、サービスプロバイダーのテナント用の Management API access token を取得します。
   cd bin/
   export access_token='<sp-tenant-management-api-token>'
   
2. destination URL を更新します。
   ./sp-set-destination-url.sh -i <saml-connection-id> -d https://oldfed.example.com/login/callback
   
3. recipient URL を更新します。
   ./sp-set-recipient-url.sh -i <saml-connection-id> -r https://oldfed.example.com/login/callback