独自の Azure Static Web Apps アカウントに静的サイトをデプロイする

接続によって実現すること

お客様ご自身の Azure Static Web Apps アカウントを接続することで、Zinn® のダッシュボードからお客様の Azure Static Web Apps アカウントへ静的サイトを公開できるようになります。プロジェクトと請求の所有権はお客様にあり、デプロイ、カスタムドメイン、DNS レコードの管理は弊社が担当します。

開始する前に

Azure サブスクリプション、サイト用のリソースグループ、そしてコードがホストされている接続済みの GitHub、GitLab、または Bitbucket のアカウントが必要です — Azure Static Web Apps はリポジトリからビルドを行います。Azure の無料プランでは商用利用が可能で、アプリごとに2つのカスタムドメインが許可されています。

1. Azure Static Web Apps でキーを作成する

Azure ではこれをサービスプリンシパルと呼びます。Microsoft Entra 管理センターで Entra ID → アプリの登録 → 新規登録 を開き、名前を入力して 登録 します。アプリの概要ページで アプリケーション (クライアント) ID と ディレクトリ (テナント) ID をコピーします。次に 証明書とシークレット → クライアント シークレット → 新しいクライアント シークレット を開き、有効期限を選択して 追加 します — Azure で表示されるのは一度だけですので、シークレットの値をすぐにコピーしてください。

Azure portal で、弊社に使用を許可するリソースグループを開き、アクセス制御 (IAM) → 追加 → ロール割り当ての追加 を選択します。共同作成者 ロールを選択し、割り当て先として ユーザー、グループ、またはサービス プリンシパル を指定し、名前でアプリを検索して 確認と割り当て を行います。リソースグループ名と、それが属する サブスクリプション ID を控えておきます (portal 内で サブスクリプション を検索してください)。

2. ここで接続する

ダッシュボードで 連携 を開き、アカウントを接続 を選択します。グループとして Static hosting (Netlify, Vercel) を、アカウントとして Azure Static Web Apps を選択し、クライアント ID、クライアント シークレット、テナント ID、サブスクリプション ID、リソースグループ を入力して アカウントを接続 を押します。

入力内容が保存される前に、貼り付けられた情報のテストを行います。機能しないキーが保存されることは決してなく、エラーの原因が表示されます。機能するキーは弊社のシークレット保管庫に暗号化されて保管され — データベースに保管されることは決してありません — お客様に対しても含め、二度と表示されません。

次のステップ

• 静的サイトを作成または移行する際、このアカウントがデプロイ先として表示されます。

Azure Static Web Apps はリポジトリからビルドを行い、アップロードされたビルドを受け付ける手段がないため、サイトのコードは接続された GitHub、GitLab、または Bitbucket のリポジトリから取得する必要があります。まだ接続していない場合は、まずいずれかを接続してください。

• 弊社がお客様のアカウント上にサービスを作成し、リポジトリを指定して、カスタムドメインを設定し、デプロイをトリガーします。ドメインのページには、Azure Static Web Apps が必要とするすべての DNS レコードが表示されます。
• 使用量と請求はお客様のアカウントに帰属し、お客様ご自身のベンダーダッシュボードで確認できます。
• Apex ドメインは TXT レコードで、サブドメインは CNAME で検証されます。お使いのドメインにどちらが必要かは、ドメインのページに表示されます。

接続できない場合

Azure がサービスプリンシパルを拒否しました。 クライアントシークレットの有効期限が切れているか (設定した期間に応じて必ず切れます)、あるいはアプリがそのリソースグループに対する 共同作成者 権限を失っています。この2つのメッセージは似ているため、新しいシークレットを作成する前にロールの割り当てを確認してください。

何も見つかりません。 サブスクリプション ID と リソースグループ がロールを割り当てた対象と一致していること、および テナント ID がアプリを登録したディレクトリであることを確認してください。

キーが拒否されたと表示されます。 ほとんどの場合、次の3つのいずれかが原因です。余分な空白や改行を一緒にコピーしてしまった、キーの有効期限が切れている、あるいはコピーした後にキーが無効化または再生成されたことです。新しいキーを作成し、再度貼り付けてください。

接続はできるものの、その後の処理が失敗します。 キーの認証には成功していますが、実行しようとしているアクションに必要な権限が不足しています。前述の権限を持つ新しいキーを作成し、古い接続を切断した上で新しいキーを接続してください。

接続の解除

連携 を開き、該当するアカウントを見つけて 切断 を押します。これにより、保存されているキーが直ちに削除されます。そのキーを使用していたすべての処理は次回のアクション時に停止し、キーに依存していた画面には、静かに失敗するのではなくその旨が表示されます。

接続を解除しても、すでに完了した処理が元に戻ることはありません — お客様のアカウント上で弊社が変更したレコード、デプロイ、設定はそのまま残ります。キー自体の漏洩が疑われる場合は、ベンダー側でもキーを無効化してください。切断処理によって削除されるのは弊社の保持するコピーであり、ベンダー側のキーではありません。