Skip to content

カスタムドメインの設定 ​

EMQX Cloudでは、デプロイメントにカスタムドメインを設定することで、MQTTクライアントが所有するドメインを通じて接続できるようにできます。これは、安定したブランド化されたエンドポイントを提供し、そのドメインのTLS/SSL証明書をEMQX Cloudに管理させたい場合に便利です。

注意

この機能はEMQX v5およびv6のDedicatedおよびDedicated Flexデプロイメントで利用可能です。トライアルデプロイメント、サーバレス、またはv4デプロイメントではサポートされていません。

はじめに ​

以下の要件を満たしていることを確認してください。

  • デプロイメントはEMQX v5またはv6のDedicatedまたはDedicated Flexであり、トライアルデプロイメントではないこと。
  • ドメインを所有しており、そのDNSレコードを管理できること。
  • ドメインはサブドメインである必要があります。例:mqtt.example.com

注意

*.example.com のようなワイルドカードドメインはサポートされていません。

TIP

証明書の発行や更新に関して厳格なコンプライアンス要件がある場合は、管理された証明書の代わりに独自の証明書をアップロードすることを検討してください。

カスタムドメインの設定手順 ​

  1. EMQX Cloudコンソールにログインし、対象デプロイメントの概要ページに移動します。

  2. MQTT接続情報 セクションで、Custom Domain をクリックします。

  3. Domain ステップで、MQTTクライアントが接続に使用するカスタムドメインを入力します。

    例:

    text
    mqtt.example.com

    カスタムドメイン入力ステップ

  4. Next をクリックして DNS ステップに進みます。コンソールに表示されるCNAMEレコードをDNSプロバイダーに追加し、カスタムドメインがデプロイメントのデフォルトエンドポイントを指すようにします。

    例(コンソールに表示されるターゲットホスト名に置き換えてください):

    text
    mqtt.example.com    CNAME    h72937f5.ala.dedicated.aws.example.com

    DNS設定ステップ

  5. DNSレコードを追加した後、Next をクリックして TLS/SSL ステップに進み、Managed by EMQX Cloud を選択します。EMQX CloudがLet's Encryptの証明書を発行および更新します。

    デフォルトでは、管理された証明書は自動更新が有効になっています。必要に応じて、後で TLS/SSL Config から Disable Auto-Renewal をクリックして自動更新を無効にできます。

    ::: caution 自動更新を無効にした後は再度有効にできません。証明書の有効期限が切れる前に手動で証明書を差し替える必要があります。 :::

    管理されたTLS/SSLステップ

  6. コンソールに表示されるACME検証用のCNAMEレコードをDNSプロバイダーに追加します。

    例:

    text
    _acme-challenge.mqtt.example.com    CNAME    _acme-challenge.h72937f5.ala.dedicated.aws.example.com

    ::: caution _acme-challenge のCNAMEレコードは常に維持してください。削除すると証明書の更新に失敗する可能性があります。

    ドメインでCAAレコードを使用している場合は、letsencrypt.org が認可された発行者として登録されていることを確認してください。 :::

  7. DNSおよびTLS/SSLの設定が完了したら、Verify & Apply をクリックします。

設定の検証 ​

設定適用後、以下の方法で検証してください。

  1. デプロイメントの概要ページに戻り、接続情報にカスタムドメインが表示されていることを確認します。

  2. ローカル環境からDNSレコードを確認します。LinuxやmacOSでは dig を使用します。

    bash
    dig mqtt.example.com CNAME

    Windowsでは nslookup を使用します。

    bash
    nslookup mqtt.example.com
  3. 発行されたTLS/SSL証明書がカスタムドメインに一致していることを確認します。

    bash
    openssl s_client -connect mqtt.example.com:8883 -servername mqtt.example.com
  4. MQTTXなどのMQTTクライアントを使い、カスタムドメインとプロトコルに応じたポートで接続をテストします。

    • TCPでのMQTT: 1883
    • TLS/SSLでのMQTT: 8883
    • WebSocket: 8083
    • TLS/SSLでのWebSocket: 8084

トラブルシューティング ​

  • デプロイメントの種類やプランがサポートされていません。

    この機能はトライアルでないEMQX v5およびv6のDedicatedおよびDedicated Flexデプロイメントで利用可能です。コンソールでデプロイメントの種類を確認してください。

  • 設定したドメインが所有しているサブドメインではありません。

    ドメインを所有し、DNSレコードを追加できる必要があります。ワイルドカードドメインはサポートされていません。

  • DNSレコードのタイプが誤っています。

    コンソールに表示される正確なCNAMEレコードを使用してください。Aレコードやその他のレコードタイプは動作しません。

  • DNSの伝播がまだ完了していません。

    レコード追加後、5~10分待ってから再度試してください。dig やオンラインのDNSチェッカーで伝播状況を確認できます。

  • ACMEのCNAMEレコードが設定後に削除されているか不足しています。

    証明書の自動更新には _acme-challenge のCNAMEレコードが常に必要です。削除されている場合は再度追加してください。

  • CAAレコードが証明書の発行をブロックしています。

    ドメインでCAAレコードを使用している場合は、letsencrypt.org を認可された発行者として追加してください。