VercelのDeployment ProtectionをContent SDKアプリに使う

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

デプロイメント保護 は、開発者や編集者がサイト展開へのアクセスを制限できるVercelの機能です。

これを有効にするには、Content SDKアプリの設定に基づいていくつかの変更を加える必要があります:

  1. VercelでProtection Bypassトークン を設定してください。

  2. レンダリングホストの設定にバイパストークンを追加してください:

    1. SitecoreAIでContent Editorを開き、/sitecore/system/Settings/Services/Rendering Hosts/にあるレンダリングホストの定義に移動します。例えば、定義がvercelと名付けられた場合、開 /sitecore/system/Settings/Services/Rendering Hosts/vercel

    2. 以下のフィールドのURLにx-vercel-protection-bypass={:placeholder-token:}<bypass_token>{/:placeholder-token:} クエリ文字列パラメータを追加してください。 <bypass_token> をVercelのバイパストークン値に置き換えてください:

      • Server side rendering engine endpoint URL

      • Server side rendering engine application URL

      • Server side rendering engine configuration URL

      以下の例はServer side rendering engine application URLの更新されたURLを表しています:

      https://<vercel_deployment_url>/?x-vercel-protection-bypass=<bypass_token>
  3. もしVercelを編集ホストとして使っているなら、SitecoreAIのContent Editorにいる間に、以下のクエリ文字列パラメータを追加Server side rendering engine application URL:

    x-vercel-set-bypass-cookie=samesitenone

    例えば:

    https://<vercel_deployment_url>/?x-vercel-protection-bypass=<bypass_token>&x-vercel-set-bypass-cookie=samesitenone
  4. 自動生成された展開URL以外の展開でDeployment Protectionが有効で、そのURLをレンダリングホストエンドポイントとして使用している場合、Vercelで以下の手順を行ってください。

    1. 環境変数PUBLIC_URL追加します。

    2. 新しい変数の値は、レンダリングホストの設定で使われているプロトコルとホスト名(例: https://{:placeholder-token:}<vercel_deployment_url>{/:placeholder-token:})に設定してください。

  5. PagesでSitecoreAI FormsおよびBYOCコンポーネントを使用したい場合は、Componentsアプリケーションでレンダリングホストの設定も必要です。以下のように:

    1. SitecoreAIダッシュボードからComponentsアプリにアクセスしてください。

    2. SettingタブのRendering hostの「、Vercel展開URLを入力し、以下のクエリ文字列パラメータを含みます:

      • x-vercel-protection-bypass、バイパストークンに設定します。

      • x-vercel-set-bypass-cookiesamesitenoneに設定されています。

      更新されたレンダリングホストURLの例は以下の通りです:

      https://<vercel_deployment_url>/?x-vercel-protection-bypass=<bypass_token>&x-vercel-set-bypass-cookie=samesitenone
重要

通常モードでプロテクションバイパストークンを使ってサイトにアクセスする場合は、すべての静的資産を正しくレンダリングするために、x-vercel-protection-bypassヘッダーとx-vercel-set-bypass-cookieヘッダーの両方を使うか、クエリ文字列パラメータを使う必要があります。

この記事を改善するための提案がある場合は、 お知らせください!