1. JSS Next.jsアプリのデプロイ オプション

JSSアプリでVercel Deployment Protection機能を使用する

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

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

デプロイメント保護 は、Vercelクラウドプラットフォームの機能で、開発者や編集者はサイトのデプロイメントへのアクセスを制限できます。この機能を有効にするには、JSSアプリの構成方法に基づいていくつかの変更を加える必要があります。

デプロイメント保護をJSSアプリケーションで使用するには:

  1. アプリのscripts\config\plugins\fallback.tsファイルで、publicUrlの設定方法を変更します。例えば：

    const publicUrlFallback = (process.env.NODE_ENV !== 'production' ? getPublicUrl() : '');
return Object.assign({}, config, {
  publicUrl: config.publicUrl || publicUrlFallback,
});
    大事な

    デプロイメント保護が有効なVercel URLの1つを編集用のレンダリング ホスト エンドポイントとして使用している場合は、この手順の残りの手順を完了して、Sitecoreの編集ツールがProtection BypassでVercelデプロイメントを使用できるようにする必要があります。それ以外の場合は、これ以上の変更は必要ありません。

  2. VercelでProtection Bypassトークン を構成します。

  3. バイパス トークンをレンダリング ホスト設定に追加します (SXAを使用するか、ローカル ファイルの編集を使用するかによって、サイト設定を構成します)。

    SXA サイト設定

    1. SXAで、/sitecore/system/Settings/Services/Rendering Hosts/にあるレンダリング ホスト定義を開きます。たとえば、定義の名前がvercelの場合は、/sitecore/system/Settings/Services/Rendering Hosts/vercelを開きます。

    2. クエリ文字列パラメーター x-vercel-protection-bypass={:placeholder-token:}<bypass_token>{/:placeholder-token:} を次のフィールドのURLに追加し、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>
    設定ファイルのサイト設定

    アプリの設定ファイルを開き、アプリケーションの <app> ノードで、クエリ文字列パラメータx-vercel-protection-bypass={:placeholder-token:}<bypass_token>{/:placeholder-token:} を次の属性の値に追加し、Vercelからのバイパス トークン値が含まれていることを確認します。

    • serverSideRenderingEngineEndpointUrl

    • serverSideRenderingEngineApplicationUrl

    次の例は、serverSideRenderingEngineApplicationUrlの更新されたURLを表しています。

    https://<vercel_deployment_url>/?x-vercel-protection-bypass=<bypass_token>

  4. Vercel Deployment Protectionが 自動生成されたURL以外のデプロイメントURLに対して有効になっており、この他のURLをレンダリング ホスト エンドポイントとして使用している場合は、Vercelで次の操作を行います。

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

    2. 新しい変数の値を、レンダリング ホスト設定で使用されるプロトコルとホスト名 ( https://{:placeholder-token:}<vercel_deployment_url>{/:placeholder-token:}など) に設定します。

大事な

Protection Bypassトークンを使用して通常モードでサイトにアクセスする場合は、x-vercel-protection-bypassヘッダーとx-vercel-set-bypass-cookie ヘッダーの両方を使用するか、クエリ文字列パラメーターを使用して、すべての静的アセットを適切にレンダリングする必要があります。

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