メインコンテンツにスキップ

カスタムドメインの設定とHTTPS/SSLのトラブルシューティング

Help Centerのカスタムドメイン設定で問題が発生していますか?この記事では試せるトラブルシューティング手順を紹介します。

対応者:Ivan Branimir Skoric

HTTPS(手動設定)またはHTTPの設定

カスタムドメインでHTTPSまたはHTTPを有効にするには:

  • Settings > Help Center > Configure & Styleに移動します

  • "Domain"セクションで、"Security protocol"の設定を探します

  • "Security protocol"をHTTPS(手動設定)またはHTTPに設定します

  • 変更を保存します

正しいCNAMEが設定されているか確認してください

HTTPS(手動設定)またはHTTPを使用している場合、CNAMEレコードが以下に設定されているか確認してください:

  • ワークスペースが米国にホストされている場合 - custom.intercom.help

  • ワークスペースがヨーロッパにホストされている場合 - custom.eu.intercom.help

  • ワークスペースがオーストラリアにホストされている場合: custom.au.intercom.help

HTTPS(クイックセットアップ)を使用している場合、CNAMEレコードが以下に設定されているか確認してください:

  • ワークスペースが米国にホストされている場合 - us.intercomhelpcenter.com

  • ワークスペースがヨーロッパにホストされている場合 - eu.intercomhelpcenter.com

  • ワークスペースがオーストラリアにホストされている場合: au.intercomhelpcenter.com

HTTPS(クイックセットアップ)はワークスペースによっては利用できない場合があります。

ワークスペースのホスティング地域を確認するには、Intercomを使用中のブラウザのURLバーを見てください。

URLが次で始まる場合:

  • app.intercom.com、ワークスペースは米国にホストされています

  • app.eu.intercom.com、ワークスペースはヨーロッパにホストされています

  • app.au.intercom.com、ワークスペースはオーストラリアにホストされています

CNAMEの変更が反映されているか確認してください

CNAMEの変更は反映に時間がかかります。プロバイダーによっては最大72時間かかることがあります。

MXToolboxなどのツールでCNAMEの反映状況を確認できます。

DNSの反映確認に便利なツールとしてwhatsmydns.netもあり、DNS変更が世界中に反映されているか確認できます。

MXToolboxではCNAME Lookupを使用してください

HTTPS(手動設定)を使用している場合、通常CNAMEチェックはデータを返しません。DNSがIntercomドメインにリンクされる必要がないためです。HTTPSの設定はサービス内で行います。

Cloudflareの設定を確認してください

Cloudflareを使用している場合、CNAMEレコードの横のクラウドがオレンジ色で、"Crypto"セクションのSSLが"Flexible"または"Full"に設定されていることを確認してください。

‘Full (Strict)’は選ばないでください。無効なSSL証明書になります。

Help Centerがライブ設定になっていることを確認してください

Settings > Help Centerに移動し、Help Centerがライブに設定されていることを確認してください。

Intercom Help CenterのSSLエラーの解決方法

Intercom Help CenterでERR_SSL_VERSION_OR_CIPHER_MISMATCHSSL_ERROR_NO_CYPHER_OVERLAPのSSLエラーが発生した場合、ブラウザとサーバー間の安全な接続に問題があることを示します。このガイドで問題の理解と解決を支援します。

ERR_SSL_VERSION_OR_CIPHER_MISMATCHの理解

このエラーは、ブラウザがSSL(Secure Sockets Layer)設定の問題でサーバーとの安全な接続を確立できない場合に発生します。

主な原因

DNS設定の誤りや伝播遅延:DNS(Domain Name System)レコードが誤って設定されているか、インターネット全体に完全に伝播していない可能性があります。

例:Intercomのus.intercomhelpcenter.comを指すCNAME(Canonical Name)レコードがまだ伝播していない場合。

ヒント:DNS変更が反映されるまで最大24時間待ちましょう。DNS伝播はドメインプロバイダーやISPによって時間がかかることがあります。

競合または重複したSSL証明書:カスタムドメインのHTTPS(クイックセットアップ)を使用している場合、IntercomがSSL証明書を提供します。ドメインプロバイダー内で設定された競合または追加の証明書はエラーの原因となるため削除してください。

プロのヒント:カスタムドメインにはIntercomが提供するSSL証明書のみを有効にして競合を避けましょう。

SSL_ERROR_NO_CYPHER_OVERLAPの理解

この問題は、SSL/TLS(Transport Layer Security)ハンドシェイク中にサーバーとクライアントが対応する暗号化プロトコルや暗号スイートで合意できない場合に発生します。

暗号スイートの問題の解決

最新の暗号化標準を使用していることを確認:ブラウザとサーバーの両方が最新の暗号化標準をサポートしている必要があります。

注意:古いブラウザやOSは最新の暗号化プロトコルをサポートしていない場合があり、このエラーの原因となります。

ヒント:ウェブブラウザを最新バージョンに更新して、最新の暗号化標準をサポートしていることを確認してください。


リンクブランディングのSSLハンドシェイクエラーの対処

Intercomはカスタムドメインのリンクブランディング用SSLを設定しません。リンクブランディングのSSL証明書はドメインプロバイダーで設定・管理する必要があります。

リンクブランディングのSSL問題の解決

ドメインプロバイダーのSSL設定を確認:リンクブランディングのSSLハンドシェイク問題を解決するには、ドメインプロバイダーで直接SSL証明書を設定してください。

注意:これはHelp Centerのメインドメイン用にIntercomが提供するSSL証明書とは別です。

重要:SSL証明書の設定やトラブルシューティングについては、ドメインプロバイダーのドキュメントやサポートを参照してください。

SSL証明書を第三者プロバイダーで管理している場合は、有効期限が切れていないか確認してください。

少なくとも1つの記事が公開されていることを確認してください

Help Centerにアクセスした際にNot foundが表示される場合、少なくとも1つの記事が公開されているか確認してください。記事が公開されていないとHelp Centerは非アクティブとなり、Not foundが返されます。

エラー1014 - CNAMEクロスユーザー禁止

カスタムHelp Centerドメインにアクセスした際にエラー1014が発生した場合、CloudflareのクロスユーザーCNAME問題が原因の可能性があります。解決方法は以下の通りです:

  • Cloudflare DNS設定:CNAMEレコードがCloudflareでDNSのみモード(グレーのクラウドアイコン)に設定されていることを確認してください。プロキシモード(オレンジのクラウドアイコン)は1014エラーの原因になります。

  • CNAMEレコード:CNAMEレコードを作成し、カスタムドメインがcustom.intercom.helpまたはus.intercomhelpcenter.comHTTPS設定方法による)を指していることを確認してください。

  • DNS伝播に最大48時間かかる場合があります。問題が続く場合はサーバー設定の調査が必要です。

エラー1014のよくある見落とし原因は、CNAMEレコード作成後にIntercom Help Center設定で正しいセキュリティプロトコルを選択していないことです。DNSが正しく設定されていても、このステップを完了しないとカスタムドメインは検証されません。解決するには、Settings > Help Center > Configure & StyleDomainセクションでDNS設定に合ったオプションを選択してください。CNAMEがus.intercomhelpcenter.comを指す場合はHTTPS(クイックセットアップ)custom.intercom.helpを指す場合はHTTPS(手動設定)です。選択後は必ず保存してください。

重要:Cloudflare Enterprise以上のプランを利用している場合、ドメインのZone Holdが無効になっていることを確認してください。Zone Holdはホスト名が同じCloudflareアカウントのIPアドレスに解決されることを検証し、HTTPSクイックセットアップの動作を妨げ、1014 Cross-User Bannedエラーを返します。無効にするにはCloudflareアカウント設定で該当ドメインのZone Holdをオフにしてください。

HTTPS設定中の「アクセス拒否」エラー

HTTPS設定中に「アクセス拒否」エラーが発生した場合:

  • CNAMEレコードが正しい地域のドメインを指しているか再確認してください

  • Cloudflareを使用している場合、SSLモードが「Flexible」または「Full」(「Full (Strict)」ではない)に設定されていることを確認してください

  • HTTPS設定を一度オフにして数分待ち、再度オンにすることでSSL設定を再起動するのが推奨されるトラブルシューティング手順です。

Amazon CloudFrontを使用していますか?

ガイドのすべての手順に従っていることを確認してください。

カスタムリバースプロキシを使用していますか?

  • ガイドに従ってください。

  • リバースプロキシ設定のCNAMEルックアップ例:何も見つかりませんが、使用しているDNSサーバーはわかります。


custom.domain/robots.txtにアクセスすると502エラーが発生しますか?

nginx(またはingress nginx)を使用している場合、ログを確認してください:

“upstream sent too big header while reading response header from upstream”

ログにこのメッセージがある場合、ingressのアノテーションでバッファサイズを増やす必要があります(デフォルトは4k):

nginx.ingress.kubernetes.io/proxy-buffer-size: "8k"


これでcustom.domain/robots.txtアクセス時の502エラーは解決します。

HTTPS設定ステータスが長時間「保留」のままの場合は?

HTTPS設定ステータスが長時間「保留」のままの場合、以下の手順を実行してください:

  • DNS設定の一般的な問題を再確認してください:
    • CNAMEレコードが正しくフォーマットされており、余分なドメイン部分(例:Intercomホストに自分のドメインを追加しない)が含まれていないこと。
    • AレコードではなくCNAMEレコードを使用していること。
    • CNAMEが正しいIntercom地域ドメイン(例:米国ワークスペースはus.intercomhelpcenter.com)を指していること。

  • 修正後、DNS伝播のために時間を置いてください。伝播にはプロバイダーによって1時間から72時間かかることがあります。

  • DNSが正しく設定され伝播したら、Help Center設定に戻り、HTTPS(クイックセットアップ)を再度有効にしてください。

  • これらの手順後もステータスが「保留」のままで十分な時間が経過した場合、DNS設定に誤りがないか再確認してください。

長期的なセキュリティと安定性を確保するには?

HTTPSクイックセットアップが有効で正常に動作していれば、設定変更や誤設定がない限り問題は再発しにくいです。Intercomはこのセットアップの一環としてSSL証明書を提供し、信頼性を確保します。

記事やコレクションページのリンクは自動的にカスタムドメインにリダイレクトされますか?

カスタムドメイン設定後、記事リンクは自動的にリダイレクトされますが、コレクションページのリンクは直接アクセスするとデフォルトのIntercomドメインで読み込まれる場合があります。SEOを重視する場合は、コレクションをカスタムドメイン対応に適切に更新してください。

再有効化や支払い停止後のシナリオ

Help Centerの再有効化や支払い停止の解決後に問題が発生した場合:

  • Intercom内のカスタムドメイン設定を確認し、すべての項目が正しく更新されていることを確認してください。

  • 必要に応じてトラブルシューティング中はカスタムドメインを削除し、一時的にデフォルトのIntercomドメインに戻してください。


まだ問題が解決しませんか?

上記の内容がすべて正しい場合で問題が続く場合は、Messenger経由でサポートチームにお問い合わせください。喜んで調査いたします!

こちらの回答で解決しましたか?