Skip to main content
カスタムドメインで証明書を管理するには、Enterprise サブスクリプションが必要です。詳細については、Auth0 Pricing と Login をご覧ください。
Auth0 の支援を受けずに の証明書を自分で管理する場合は、そのドメイン上で複数の DNS レコードを必要とする受信接続に対応できるよう、自身のプロキシと証明書の管理方法を把握しておく必要があります。証明書は自分で購入または用意し、更新も自分で管理しなければなりません。また、証明書をインストールするリバースプロキシも必要です。ドメインの検証が完了すると、Auth0 はそのプロキシからのトラフィックを受け入れます。 このオプションを選ぶ理由は次のとおりです。
  • 証明書をより細かく制御できる (たとえば、独自の CA や証明書の有効期限を選択できる) 。
  • Auth0 への API 呼び出しに対する監視を強化できる。
自己管理証明書を使用してカスタムドメインを設定するには、ドメイン名を Auth0 に提供し、そのドメインの所有権を確認したうえで、リバースプロキシを設定する必要があります。カスタムドメインの設定が完了したら、Auth0 の各機能でもカスタムドメインを使用するよう設定する必要があります。
Auth0 へのプロキシでは、TLS (SSL) バージョン 1.2 以降を使用する必要があります。

​
Auth0 にドメイン名を登録する

  1. Auth0 Dashboard > Settings > カスタムドメイン または Auth0 Dashboard > Branding > カスタムドメイン に移動します。表示されたボックスにカスタムドメインを入力し、ドロップダウンメニューから 自己管理証明書 を選択します。
  2. Add Domain を選択します。 ドメインを追加した後も Add Domain ボタンは表示されますが、1 つのテナントに追加できるドメインは 1 つだけです。

​
所有権を確認する

Auth0 でこのドメインを使用する前に、そのドメインの所有権を確認する必要があります。
  1. Auth0 Dashboard > ブランディング > カスタムドメイン に移動します。
    Auth0 Branding Custom Domains Self-Managed Certificate Verify Domain
  2. TXT 検証情報をドメインの DNS レコードに追加します。 手順は、ドメインホスティングプロバイダーによって異なる場合があります。
    1. 値をコピーできるように、ブラウザーで Auth0 のカスタムドメインのページを開いたままにします。
    2. ドメイン管理サービスにログインします。
    3. 新しいレコードを作成し、次の設定で保存します。
  3. Verify をクリックして続行します。 DNS 設定によっては、Auth0 がドメインを検証できるようになるまで数分かかる場合があります。 Auth0 によるドメイン名の検証が成功すると、確認ウィンドウが表示されます。 このウィンドウに表示される情報、特に cname-api-key の値は保存してください。この値を確認できるのは このときだけ です。
    セキュリティ上の理由により、この値は保存時にハッシュ化されるため、復元できません。この時点で cname-api-key を控えなかった場合は、カスタムドメインを再作成する必要があります。
    これで検証プロセスは完了です。1〜2 分以内にカスタムドメインを使用できるようになります。3 日以内に検証プロセスを完了できない場合は、これらの手順をもう一度実行してください。

​
リバースプロキシを設定する

リバースプロキシサーバーは、アプリケーションの代わりに 1 つ以上のサーバーからリソースを取得します。取得したリソースはアプリケーションに返され、あたかもリバースプロキシサーバー自体から送られてきたかのように見えます。 Cloudflare、Azure CDN、Google Cloud Platform、AWS Cloudfront などのサービスを使用して、カスタムドメイン用の設定を行えます。配信用に、リバースプロキシサーバーのドメイン名を指す新しい CNAME 値を、カスタムドメインの DNS に追加します。
  1. サービス側でリバースプロキシの設定を作成したら、Auth0 Dashboard > Branding > カスタムドメイン タブに移動します。
  2. 配信用のサービスドメイン名を指す新しい CNAME レコードを、カスタムドメインの DNS に追加します。これは、リバースプロキシサーバーの設定で Distribution ID を確認すると見つかります。 追加後は、証明書更新時の問題を避けるため、CNAME レコードを常に維持しておく必要があります。
  3. プロキシサーバーの設定方法は、使用するサービスによって異なります。通常は、次の種類の設定が必要になります。

​
ディストリビューションの設定

​
オリジンホスト名の設定

カスタムドメインの詳細の取得方法について詳しくは、Get custom domain configurations を参照してください。

​
HTTP ヘッダー

Auth0 は、異常検知、レート制限、MFA などの機能でエンドユーザーの IP アドレスを使用します。プロキシがエンドユーザーの IP アドレスを転送しない場合、Auth0 はプロキシの IP アドレスをクライアントの IP アドレスとして扱うため、これらの機能が正しく動作しない可能性があります。

​
デフォルトのキャッシュ動作設定

​
特定の Auth0 機能に関する追加手順

利用している Auth0 の機能によっては、追加で設定が必要になる場合があります。詳しくは、カスタムドメインを使用する機能を設定するを参照してください。 Cloudflare では、CNAME flattening という機能が使用されており、DNS レコードの処理方法により、Auth0 の検証や証明書の更新に影響します。特別な必要がない限り、CNAME flattening は無効にすることをお勧めします。 この機能では証明書を自分で管理することになるため、攻撃を受けた際にリクエストを遮断するための対策 (Web アプリケーションファイアウォールなど) を検討する必要があります。詳しくは、ボット対策の今後について解説したブログ記事をご覧ください。

​
詳細情報