言語別URL設定機能:サブドメイン(転送)方式の設定

お使いのCDN・Webサーバーで、言語ごとのサブドメイン(例:en.example.com)へのリクエストを翻訳サーバーに転送する方式です。言語ごとのサブドメインのうち、一部のディレクトリ(例:/blog 配下)だけを翻訳ページにすることもできます。

この記事は、CDN・Webサーバーの設定をご担当の方向けです。設定する値は、管理画面の「言語別URL」の「4. 設定と接続テスト」に、お客様のドメインと言語に合わせて表示されます。管理画面での操作は 言語別URL設定機能 をご覧ください。

#概要

URLの形

例1:サイト全体を翻訳する場合

元言語URL:https://example.com/about
英語URL:https://en.example.com/about
韓国語URL:https://ko.example.com/about

例2:一部のディレクトリのみを翻訳する場合(/blog 配下のみ)

元言語URL:https://example.com/blog/article-1
英語URL:https://en.example.com/blog/article-1   ← 翻訳サーバーに転送
韓国語URL:https://ko.example.com/blog/article-1 ← 翻訳サーバーに転送

https://en.example.com/company など /blog 以外のパス ← 今までの配信先のまま

例3:先頭のサブドメイン(www)を言語コードに置き換える場合

元言語URL:https://www.example.com/about
英語URL:https://en.example.com/about
韓国語URL:https://ko.example.com/about
  • 元言語のページと同じパスで、翻訳ページが表示されます。
  • どの形にするかと、各言語のURLに入る文字列は、管理画面の「2. 言語ごとのURLを決める」で決めます。文字列は、通常は言語コード(言語コード一覧)です。eng のように、言語コードと異なる文字列(英小文字とハイフン、20文字以内)にすることもできます。
  • サイト全体か一部のディレクトリのみかは、管理画面の「3. 接続方法を選ぶ」で選びます。

仕組み

  1. 訪問者が言語ごとのサブドメイン(en.example.com)にアクセスすると、リクエストがお使いのCDN・Webサーバーに届きます。
  2. お使いのCDN・Webサーバーが、リクエストを翻訳サーバーに転送します。その際、どの言語のページへのリクエストかを X-Autolingual-Host ヘッダーで翻訳サーバーに伝えます。
  3. 翻訳サーバーが、元言語のページ(example.com)を取得して翻訳し、お使いのCDN・Webサーバーを通して訪問者に返します。
  • 元言語のページには、Autolingual のスクリプトタグが入っている必要があります。

パス方式・サブドメイン(DNS)方式との違い

サブドメイン(転送)方式パス方式サブドメイン(DNS)方式
URLの例en.example.com/aboutexample.com/en/abouten.example.com/about
翻訳サーバーに届く経路お使いのCDN・Webサーバーから転送お使いのCDN・Webサーバーから転送DNSで直接
X-Autolingual-Host の値言語ごとのサブドメイン(en.example.com)。言語ごとに変わりますサイトのホスト(example.com)。言語によらず同じです不要
SSL証明書お客様が用意今のサイトの証明書のままAutolingual が発行

設定の内容は、パス方式とほぼ同じです。サブドメイン方式ではURLのパスに言語コードが入らないため、どの言語へのリクエストかを X-Autolingual-Host ヘッダーで伝えていただく必要があります。

#前提条件

  • 言語ごとのサブドメインのDNSレコードを、お使いのCDN・Webサーバーに向けられること
  • 言語ごとのサブドメインのSSL証明書を、お使いのCDN・Webサーバーで用意できること
  • お使いのCDN・Webサーバーで、転送の条件・転送先・リクエストヘッダーを設定できること

#設定の流れ

作業
1管理画面で、方式・言語ごとのURL・接続方法を選ぶ
2言語ごとのサブドメインを、お使いのCDN・Webサーバーに向け、SSL証明書を用意する
3言語ごとのサブドメインへのリクエストを、翻訳サーバーに転送する
4必要な場合は、WAFなどで翻訳サーバーからのアクセスを許可する
5管理画面で接続テストを実行し、言語別URLを適用する

#設定する値

この方式で使う値の一覧です。

値内容どこで決まるか
言語ごとのサブドメインen.example.com など管理画面の「2. 言語ごとのURLを決める」で決めます
転送するディレクトリ/blog など(一部のディレクトリのみの場合)管理画面の「3. 接続方法を選ぶ」で決めます
転送先(翻訳サーバー)https://language-proxy.autolingual.io
X-Autolingual-Host訪問者がアクセスした言語ごとのサブドメイン(en.example.com など)
X-Autolingual-Token英数字の文字列管理画面の「4. 設定と接続テスト」に表示されます
翻訳サーバーのIPアドレス(アクセスの許可用)34.146.109.214、34.180.99.220

この記事の設定例では、X-Autolingual-Token の値を ${トークン} と書いています。実際の値に置き換えてください。

#転送の設定

どのCDN・Webサーバーでも、次のように設定します。各CDN・Webサーバーでの設定方法は、「CDN・Webサーバーごとの設定」をご覧ください。

項目設定内容
転送する条件言語ごとのサブドメインへのリクエスト。一部のディレクトリのみの場合は、そのディレクトリとその配下(例:en.example.com/blog、en.example.com/blog/*)
転送先https://language-proxy.autolingual.io(HTTPS、ポート443)
Host ヘッダーlanguage-proxy.autolingual.io。訪問者がアクセスしたホスト(en.example.com)のまま転送しないでください
URLのパスとクエリ変えずに転送してください(en.example.com/blog/article-1?page=2 は /blog/article-1?page=2 のまま)
X-Autolingual-Host訪問者がアクセスした、言語ごとのサブドメイン(例:en.example.com)。言語ごとに値が変わります
X-Autolingual-Token管理画面に表示される値を設定してください
  • X-Autolingual-Host と X-Autolingual-Token は、リクエストにすでに同じ名前のヘッダーがあっても上書きしてください。訪問者が付けたヘッダーがそのまま届かないようにするためです。

  • X-Autolingual-Host の値には、https:// や末尾の / を含めないでください。

    • ○ en.example.com
    • ○ en.www.example.com(www の前に言語コードを付ける場合)
    • × example.com(言語ごとのサブドメインになっていない)
    • × www.example.com(元言語のURLが www で始まる場合も、言語ごとのサブドメインにしてください)
    • × https://en.example.com
    • × en.example.com/
  • X-Autolingual-Token は、翻訳サーバーに届いたリクエストが、お使いのCDN・Webサーバーを経由した正規のリクエストであることを確認するために使います。値は公開しないでください。

  • 翻訳サーバーのリダイレクト(Location ヘッダー)は、そのまま訪問者に返してください。

  • 元言語のドメイン(example.com)へのリクエストは、今までどおり配信してください。翻訳サーバーも、元言語のページをこのドメインから取得します。

  • 訪問者の Cookie・User-Agent などのヘッダーも、そのまま転送してください。翻訳サーバーは、これらのヘッダーを付けて元言語のページを取得します。

#CDN・Webサーバーごとの設定

各CDN・Webサーバーでの推奨設定です。管理画面に表示される設定例も、この推奨設定に沿っています。サイトの構成に合わせて調整してください。「転送の設定」の内容を満たしていれば、ほかの方法で設定していただいてもかまいません。

設定例は、元言語のURLが example.com、翻訳先言語が英語(en.example.com)と韓国語(ko.example.com)の場合です。

#CloudFront

推奨設定:CloudFront Functions で転送する

CloudFront Functions で、言語ごとのサブドメインへのリクエストだけ転送先を翻訳サーバーに切り替える設定です。元言語のサイトと言語ごとのサブドメインを、1つのディストリビューションで配信します。オリジン・ビヘイビアを追加する必要はありません。

1. ディストリビューションに言語ごとのサブドメインを追加する

元言語のサイトのディストリビューションの代替ドメイン名に、言語ごとのサブドメインを追加してください。SSL証明書(ACM)にも、言語ごとのサブドメインを含めてください。

代替ドメイン名
en.example.com
ko.example.com

2. CloudFront Functions で関数を作成する

次のコードで関数を作成してください。ランタイムは cloudfront-js-2.0 を選んでください。すでにビューアーリクエストに関数を関連付けている場合は、その関数にこの処理を加えてください。

import cf from "cloudfront";

// 言語ごとのサブドメイン
const LANGUAGE_HOSTS = ["en.example.com", "ko.example.com"];

function handler(event) {
  const request = event.request;
  delete request.headers["x-autolingual-host"];
  delete request.headers["x-autolingual-token"];
  if (LANGUAGE_HOSTS.includes(request.headers.host.value)) {
    request.headers["x-autolingual-host"] = { value: request.headers.host.value };
    cf.updateRequestOrigin({
      domainName: "language-proxy.autolingual.io",
      originAccessControlConfig: { enabled: false },
      customOriginConfig: {
        port: 443,
        protocol: "https",
        sslProtocols: ["TLSv1.2"],
      },
      customHeaders: {
        "x-autolingual-token": "{トークン}",
      },
    });
  }
  return request;
}

一部のディレクトリのみ転送する場合のコード

/blog 配下だけを転送する場合です。FORWARD_PATH の条件が加わります。

import cf from "cloudfront";

// 言語ごとのサブドメイン
const LANGUAGE_HOSTS = ["en.example.com", "ko.example.com"];
// 転送するディレクトリ
const FORWARD_PATH = /^(\/blog)(\/|$)/;

function handler(event) {
  const request = event.request;
  delete request.headers["x-autolingual-host"];
  delete request.headers["x-autolingual-token"];
  if (LANGUAGE_HOSTS.includes(request.headers.host.value) && FORWARD_PATH.test(request.uri)) {
    request.headers["x-autolingual-host"] = { value: request.headers.host.value };
    cf.updateRequestOrigin({
      domainName: "language-proxy.autolingual.io",
      originAccessControlConfig: { enabled: false },
      customOriginConfig: {
        port: 443,
        protocol: "https",
        sslProtocols: ["TLSv1.2"],
      },
      customHeaders: {
        "x-autolingual-token": "{トークン}",
      },
    });
  }
  return request;
}

転送するディレクトリが複数ある場合は、/^(\/blog|\/news)(\/|$)/ のように | で区切ります。転送しないパスへのリクエストは、ディストリビューションの今のオリジンに届きます。

3. 関数を発行し、ビヘイビアに関連付ける

設定項目値
ビヘイビアDefault (*)
イベントタイプViewer request
関数タイプCloudFront Functions
関数作成した関数

ほかにビヘイビアがあり、言語ごとのサブドメインへのリクエストがそのビヘイビアにも一致する場合は、そのビヘイビアにも関連付けてください。

4. キャッシュポリシーのキャッシュキーに X-Autolingual-Host を入れる

元言語のサイトと言語ごとのサブドメインで、キャッシュを分けるための設定です。マネージドポリシーでは設定できないため、マネージドポリシーをお使いの場合は、今のポリシーと同じ内容のカスタムポリシーを作成して切り替えてください。

設定項目値
ヘッダー次のヘッダーを含める
追加するヘッダーX-Autolingual-Host

キャッシュを使わない(CachingDisabled)場合は、代わりにオリジンリクエストポリシーで X-Autolingual-Host を転送してください。

5. 言語ごとのサブドメインを CloudFront に向ける

DNSで、言語ごとのサブドメインをディストリビューション(xxxx.cloudfront.net)に向けてください。Route 53 をお使いの場合は、エイリアスレコードでもかまいません。

  • 関数は、転送先と X-Autolingual-Token をまとめて設定します。転送先を変えると、Host ヘッダーも翻訳サーバーのものになります。
  • 関数の最初の2行は、訪問者が付けた X-Autolingual-Host・X-Autolingual-Token を消す処理です。訪問者が同じ名前のヘッダーを付けていると、関数で設定する値を付けられないためです。
  • originAccessControlConfig: { enabled: false } は、今のオリジンが S3(オリジンアクセスコントロールあり)の場合に、S3 用の署名を翻訳サーバーに送らないための設定です。
  • 関数で転送先を切り替えたリクエストにも、関連付けたビヘイビアのキャッシュポリシー・オリジンリクエストポリシーがそのまま使われます。CachingOptimized のようにクエリ・Cookie をオリジンに送らないポリシーの場合は、翻訳サーバーにもクエリ・Cookie が届かず、翻訳ページも CloudFront にキャッシュされます(翻訳を直しても、キャッシュの期限まで前の翻訳が表示されます)。その場合は、オリジンリクエストポリシーでクエリ・Cookie を転送するか、「CloudFront Functions を使わない設定」をご検討ください。
  • 翻訳先言語を追加したときは、LANGUAGE_HOSTS に追加して関数を発行し直してください。

CloudFront Functions を使わない設定

CloudFront Functions を使えない場合は、オリジンとビヘイビアで設定できます。CloudFront のオリジンのカスタムヘッダーは固定の値しか設定できないため、言語ごとにディストリビューションを作成し、それぞれに X-Autolingual-Host を設定します。

言語ごとに、次の1〜4を行ってください(en.example.com の場合)。

1. ディストリビューションを作成する

代替ドメイン名に en.example.com を設定し、en.example.com を含むSSL証明書(ACM、バージニア北部リージョン)を選んでください。作成画面では、サイト全体の場合はオリジンを手順2の値、Default (*) のビヘイビアを手順3の値にしてください。一部のディレクトリのみの場合は、オリジンと Default (*) のビヘイビアを元言語のサイトと同じにし、翻訳サーバーのオリジン(手順2)と転送するディレクトリのビヘイビア(手順3)は、作成したあとに追加してください。

2. 翻訳サーバーのオリジンを作成する

設定項目値
オリジンドメインlanguage-proxy.autolingual.io
プロトコルHTTPS のみ
HTTPS ポート443
最小オリジン SSL プロトコルTLSv1.2
オリジンパス空欄
カスタムヘッダーを追加X-Autolingual-Host:en.example.com
カスタムヘッダーを追加X-Autolingual-Token:${トークン}

3. ビヘイビアを設定する

サイト全体の場合は Default (*)、一部のディレクトリのみの場合は転送するディレクトリのビヘイビア(例:/blog と /blog/* の2つ)を、手順2のオリジンに向けてください。

設定項目値
オリジン手順2のオリジン
ビューワープロトコルポリシーRedirect HTTP to HTTPS
許可された HTTP メソッドGET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE(フォームを送信するページがない場合は GET, HEAD でもかまいません)
キャッシュポリシーCachingDisabled
オリジンリクエストポリシーAllViewerExceptHostHeader

4. en.example.com を CloudFront に向ける

DNSで、en.example.com を手順1のディストリビューションに向けてください。

  • 一部のディレクトリのみの場合は、Default (*) のビヘイビアを、転送しないパスの配信先(元言語のサイトのオリジンなど)に向けてください。
  • パスパターンは、/blog* ではなく /blog と /blog/* の2つにしてください。/blog* にすると、/blog-archive のようなパスも転送されます。
  • オリジンのカスタムヘッダーは、リクエストに同じ名前のヘッダーがあっても上書きされます。
  • オリジンリクエストポリシー AllViewerExceptHostHeader は、Host ヘッダー以外のヘッダー・Cookie・クエリをオリジンに転送するマネージドポリシーです。Host ヘッダーは、オリジンドメイン(翻訳サーバー)のものになります。
  • キャッシュを使いたい場合は、キャッシュキーに Host ヘッダーを含めないキャッシュポリシーにしてください。キャッシュキーに入れたヘッダーはオリジンにも転送されるため、Host ヘッダーを入れると翻訳サーバーに訪問者のホストが届き、つながりません。

#Azure Front Door

Azure Front Door(Standard・Premium)のルールセットで設定します。Azure CDN(クラシック)は新しいプロファイルやドメインを追加できなくなっているため、ご案内していません。

1. 言語ごとのサブドメインを Azure Front Door に向ける

言語ごとのサブドメインを Front Door のカスタムドメインとして追加し、DNSで Front Door のエンドポイント(xxxx.azurefd.net)に向けてください。SSL証明書は、Front Door のマネージド証明書などで用意してください。

ホスト名向け先
en.example.comFront Door のエンドポイント(xxxx.azurefd.net)
ko.example.comFront Door のエンドポイント(xxxx.azurefd.net)

2. 翻訳サーバーの配信元グループを作成する

設定項目値
配信元の種類カスタム
ホスト名language-proxy.autolingual.io
配信元のホスト ヘッダーlanguage-proxy.autolingual.io
HTTPS ポート443

3. ルールセットで言語ごとにルールを作成する

言語ごとに、次の条件とアクションのルールを作成してください。

言語条件:ホスト名(等しい)アクション:要求ヘッダーの変更(上書き) X-Autolingual-Host
英語en.example.comen.example.com
韓国語ko.example.comko.example.com

どのルールにも、次の2つのアクションも設定してください。

アクション値
ルート構成のオーバーライド手順2の配信元グループ(転送プロトコル:HTTPS のみ、キャッシュ:無効)
要求ヘッダーの変更(上書き) X-Autolingual-Token{トークン}

一部のディレクトリのみ転送する場合の条件

各ルールに、次の条件も加えてください(/blog 配下だけを転送する場合)。

条件演算子値
要求パス正規表現下のコードの値
^(blog)(/|$)

要求パスは、先頭の / を含めない値で比べられます。転送するディレクトリが複数ある場合は、^(blog|news)(/|$) のように | で区切ります。

ルールセットは、言語ごとのサブドメインのルートに関連付けてください。

  • 配信元グループの配信元が翻訳サーバーだけの場合は、正常性プローブを無効にしてかまいません。
  • 「要求ヘッダーの変更」は「追加」ではなく「上書き」にしてください。訪問者が付けたヘッダーがそのまま届かないようにするためです。
  • 翻訳先言語を追加したときは、その言語のカスタムドメインとルールを追加してください。

#Cloudflare

Cloudflare Workers で転送します。Workers はすべてのプランでご利用いただけます(無料プランでは、1日あたり10万リクエストまでです。参照:Cloudflare のドキュメント)。

1. 言語ごとのサブドメインの DNS レコードを追加する

プロキシステータスを「プロキシ済み」(オレンジの雲)にしてください。「DNS のみ」の場合はリクエストが Cloudflare を経由しないため、手順2の Worker が動きません。

名前タイプターゲットプロキシステータス
en.example.comCNAMEexample.comプロキシ済み
ko.example.comCNAMEexample.comプロキシ済み

2. Worker を作成する

次のコードで Worker を作成し、デプロイしてください。

export default {
  async fetch(request) {
    const url = new URL(request.url);
    const host = url.hostname;
    url.protocol = "https:";
    url.hostname = "language-proxy.autolingual.io";
    const proxied = new Request(url, request);
    proxied.headers.set("X-Autolingual-Host", host);
    proxied.headers.set("X-Autolingual-Token", "{トークン}");
    return fetch(proxied, { redirect: "manual" });
  },
};

3. Worker にルートを追加する

Worker の設定で、ゾーン example.com に次のルートを追加してください。

ルート
en.example.com/*
ko.example.com/*

一部のディレクトリのみ転送する場合のルート

/blog 配下だけを転送する場合は、次のルートにしてください。Workers のルートは前方一致ではないため、ディレクトリそのもの(/blog)と配下(/blog/*)の両方を追加します。Worker のコードは同じです。

ルート
en.example.com/blog
en.example.com/blog/*
ko.example.com/blog
ko.example.com/blog/*

転送しないパスへのリクエストは、手順1の DNS レコードのターゲット(元言語のサイト)に届きます。

  • Worker は、届いたリクエストの転送先を翻訳サーバーに変え、X-Autolingual-Host(訪問者がアクセスしたホスト)と X-Autolingual-Token を上書きして転送します。
  • redirect: "manual" は、翻訳サーバーのリダイレクトをそのまま訪問者に返すための設定です。
  • DNS レコードのターゲットを元言語のサイトにしておくと、Worker が動かないときも、元言語のサイトが表示されます。
  • Cloudflare のユニバーサル SSL 証明書は、1階層のサブドメイン(en.example.com)にしか使えません。en.www.example.com のような2階層のサブドメインには、Advanced Certificate Manager などで証明書を用意してください。
  • Origin Rules では設定できません(Host ヘッダーの上書きが Enterprise プランでしか使えないため)。
  • 翻訳先言語を追加したときは、その言語の DNS レコードとルートを追加してください。

#Apache

言語ごとのサブドメインの VirtualHost を追加して、翻訳サーバーに転送します。

1. 言語ごとのサブドメインを Webサーバーに向ける

DNSで、言語ごとのサブドメインをこのWebサーバーに向けてください。SSL証明書もWebサーバー側で用意してください。

2. VirtualHost を追加する

次の設定を追加してください。mod_proxy・mod_proxy_http・mod_ssl・mod_headers が必要です。

<VirtualHost *:443>
    ServerName en.example.com
    SSLEngine On
    SSLCertificateFile /path/to/fullchain.pem
    SSLCertificateKeyFile /path/to/privkey.pem
    SSLProxyEngine On
    RequestHeader set X-Autolingual-Host "en.example.com"
    RequestHeader set X-Autolingual-Token "{トークン}"
    ProxyPass "/" "https://language-proxy.autolingual.io/"
    ProxyPassReverse "/" "https://language-proxy.autolingual.io/"
</VirtualHost>

<VirtualHost *:443>
    ServerName ko.example.com
    SSLEngine On
    SSLCertificateFile /path/to/fullchain.pem
    SSLCertificateKeyFile /path/to/privkey.pem
    SSLProxyEngine On
    RequestHeader set X-Autolingual-Host "ko.example.com"
    RequestHeader set X-Autolingual-Token "{トークン}"
    ProxyPass "/" "https://language-proxy.autolingual.io/"
    ProxyPassReverse "/" "https://language-proxy.autolingual.io/"
</VirtualHost>

一部のディレクトリのみ転送する場合の設定

/blog 配下だけを転送する場合です。転送しないパスの配信(DocumentRoot など)も、同じ VirtualHost に書いてください。

<VirtualHost *:443>
    ServerName en.example.com
    SSLEngine On
    SSLCertificateFile /path/to/fullchain.pem
    SSLCertificateKeyFile /path/to/privkey.pem
    SSLProxyEngine On
    <LocationMatch "^/(blog)(/.*)?$">
        RequestHeader set X-Autolingual-Host "en.example.com"
        RequestHeader set X-Autolingual-Token "{トークン}"
    </LocationMatch>
    ProxyPassMatch "^/(blog)(/.*)?$" "https://language-proxy.autolingual.io/$1$2"
    ProxyPassReverse "/" "https://language-proxy.autolingual.io/"
    # 転送しないパスの配信(DocumentRoot など)も、この VirtualHost に書いてください
</VirtualHost>

ko.example.com も、ServerName と X-Autolingual-Host の値を変えて同じように追加してください。転送するディレクトリが複数ある場合は、^/(blog|news)(/.*)?$ のように | で区切ります。

  • RequestHeader set は、リクエストに同じ名前のヘッダーがあっても上書きします。
  • ProxyPassReverse は、翻訳サーバーのリダイレクト先を言語ごとのサブドメインのURLに直すための設定です。
  • ProxyPreserveHost On を設定しないでください。翻訳サーバーに訪問者のホストが届き、つながりません。
  • 設定を変えたら、apachectl configtest で確かめてから再読み込みしてください。

#nginx

言語ごとのサブドメインの server ブロックを追加して、翻訳サーバーに転送します。

1. 言語ごとのサブドメインを Webサーバーに向ける

DNSで、言語ごとのサブドメインをこのWebサーバーに向けてください。SSL証明書もWebサーバー側で用意してください。

2. server ブロックを追加する

次の設定を追加してください。

server {
    listen 443 ssl;
    server_name en.example.com ko.example.com;
    ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass https://language-proxy.autolingual.io;
        proxy_set_header Host language-proxy.autolingual.io;
        proxy_set_header X-Autolingual-Host $host;
        proxy_set_header X-Autolingual-Token {トークン};
        proxy_ssl_server_name on;
    }
}

一部のディレクトリのみ転送する場合の設定

/blog 配下だけを転送する場合です。location / に、転送しないパスの配信(root など)を書いてください。

server {
    listen 443 ssl;
    server_name en.example.com ko.example.com;
    ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location ~ ^(/blog)(/.*)?$ {
        proxy_pass https://language-proxy.autolingual.io;
        proxy_set_header Host language-proxy.autolingual.io;
        proxy_set_header X-Autolingual-Host $host;
        proxy_set_header X-Autolingual-Token {トークン};
        proxy_ssl_server_name on;
    }

    location / {
        # 転送しないパスの配信(root など)
    }
}

転送するディレクトリが複数ある場合は、^(/blog|/news)(/.*)?$ のように | で区切ります。

  • X-Autolingual-Host の $host は、訪問者がアクセスしたホスト(en.example.com など)になります。1つの server ブロックで、すべての言語をまとめて転送できます。
  • proxy_set_header は、リクエストに同じ名前のヘッダーがあっても上書きします。
  • proxy_ssl_server_name on; は、翻訳サーバーへ HTTPS で接続するために必要です。
  • 設定を変えたら、nginx -t で確かめてから再読み込みしてください。

#その他のCDN・Webサーバー

「転送の設定」のとおりに設定してください。言語ごとのサブドメインのDNSレコードとSSL証明書も、お使いのCDN・Webサーバーで用意してください。

転送する条件転送先・Host ヘッダーX-Autolingual-Host(上書き)X-Autolingual-Token(上書き)
en.example.com/*language-proxy.autolingual.ioen.example.com{トークン}
ko.example.com/*language-proxy.autolingual.ioko.example.com{トークン}

一部のディレクトリのみの場合は、転送する条件を en.example.com/blog、en.example.com/blog/* のようにしてください。URLのパスは変えずに転送してください。

#一部のディレクトリだけ転送するとき

  • 翻訳ページの中にある同じサイトへのリンクは、転送しないパスへのリンクも含めて、言語ごとのサブドメインのURLに書き換わります(例:en.example.com/blog/article-1 の中の https://example.com/company へのリンクは https://en.example.com/company になります)。
  • そのため、言語ごとのサブドメインの転送しないパス(例:en.example.com/company)にアクセスされたときの表示を、あらかじめご検討ください(元言語のページへのリダイレクトなど)。
  • 転送しないパスでも翻訳したい場合は、転送するディレクトリを増やしてください。転送したパスの中で一部のページだけを翻訳対象外にする場合は、管理画面の「ページ管理」から設定できます。

#翻訳サーバーからのアクセスを許可する

翻訳サーバーは、元言語のページを取得するために、お客様のサイトにアクセスします。WAFやBot対策、IPアドレスによるアクセス制限を行っている場合は、次のIPアドレスからのアクセスを許可してください(管理画面の「4. 設定と接続テスト」にも表示されます)。

許可するIPアドレス
34.146.109.214
34.180.99.220
  • 2つとも許可してください。どちらから送られるかは決まっていません。
  • 翻訳サーバーからのリクエストには、訪問者のブラウザの User-Agent と Cookie がそのまま付きます。User-Agent では翻訳サーバーと見分けられないため、許可の条件にはIPアドレスをお使いください。
  • 元言語のサイトの前にも同じCDNがある場合は、そのCDNのWAF・Bot対策で許可してください(例:Cloudflare の場合は、WAF のカスタムルールや IP アクセスルール)。

#設定後の確認

管理画面で「接続テストを実行」を押すと、各言語のページへのリクエストが翻訳サーバーまで届いているかを確認できます。すべての言語がつながったら、管理画面で言語別URLを適用してください。

  • 適用するまでは、言語ごとのサブドメインを開いても翻訳ページは表示されません。設定が正しいかは、接続テストで確認してください。
  • 適用後、反映まで最大10分かかります。言語ごとのサブドメイン(例:https://en.example.com/about)を開き、翻訳ページが表示されることをご確認ください。
  • 適用後は、X-Autolingual-Token が届かないリクエストは翻訳サーバーで拒否されます(403)。転送の設定から X-Autolingual-Token を消さないでください。

#うまくいかないとき

接続テストの結果に表示される内容ごとに、次の点をご確認ください。

接続テストの結果確認すること
接続できませんでした言語ごとのサブドメインのDNSレコードとSSL証明書
翻訳サーバーまでリクエストが転送されていません転送する条件と転送先。元言語のページが表示される場合は、転送の条件に一致していないか、X-Autolingual-Host に元言語のホストを設定しています
X-Autolingual-Token が届いていませんX-Autolingual-Token ヘッダーを追加したか
X-Autolingual-Token の値が違います管理画面に表示される値をそのまま設定しているか
このドメインの設定が見つかりませんX-Autolingual-Host の値。https:// や末尾の / が含まれている、言語コードが含まれていない、www の扱いが「2. 言語ごとのURLを決める」と違う、など
X-Autolingual-Token と X-Autolingual-Host の値が、手順のとおりか確認してください上の2つの両方
翻訳先言語のコードを確認してくださいX-Autolingual-Host の先頭の言語コードが、「2. 言語ごとのURLを決める」の表と同じか
元のサイトがエラーを返しました翻訳元言語のページが開けるか。WAFやIPアドレス制限がある場合は「翻訳サーバーからのアクセスを許可する」をご確認ください
翻訳サーバーが元のサイトからページを取得できませんでした時間をおいて再実行してください。続く場合はお問い合わせください
別のプロジェクトにつながっていますお問い合わせください

適用後に言語ごとのサブドメインを開いてエラーになる場合は、翻訳サーバーが返すエラーごとに、次の点をご確認ください。

エラー確認すること
404(Not found)X-Autolingual-Host の値が、言語ごとのサブドメインと同じか。https:// や末尾の / が含まれている、www の扱いが違う、など
400(Invalid language code など)X-Autolingual-Host の先頭の言語コードが、公開中の翻訳先言語と同じか。非公開の言語は、「翻訳言語」の画面で公開するまで表示されません
403(Access denied)X-Autolingual-Token が付いているか、値が管理画面の表示と同じか。X-Autolingual-Host が付いているか
503・504一時的なエラーか、元言語のサイトの応答が遅い可能性があります。続く場合はお問い合わせください

#よくある質問

翻訳先言語を追加したときは、何をすればよいですか?

追加した言語のサブドメインを、お使いのCDN・Webサーバーに向けて、転送の設定に加えてください(各CDN・Webサーバーの「翻訳先言語を追加したとき」もご覧ください)。管理画面の「4. 設定と接続テスト」に、追加した言語の分も表示されます。進め方は 言語別URL設定機能 の「適用後の注意」をご覧ください。

X-Autolingual-Token が漏れてしまったときは、どうすればよいですか?

お問い合わせください。新しい値をお知らせしますので、転送の設定を差し替えてください。差し替えが終わるまでは、前の値でも転送できます。

キャッシュは使えますか?

翻訳ページは、訪問のたびに翻訳サーバーから返すことをおすすめします(Azure Front Door の推奨設定もキャッシュを無効にしています)。キャッシュを使う場合は、元言語のページと翻訳ページ、言語ごとのページで、キャッシュが分かれるようにしてください。