CODE Polyglot / 備忘録

エックスサーバーの API でサブドメインのメールアドレスを作るとき、確認用の TXT はサブドメインに置いても通らず、親ドメインに置くと通った

サブドメインのアドレスを作ろうとすると「TXTレコードによるドメイン認証に失敗しました。」で断られました。_xserver-verify の TXT をサブドメインではなく親ドメインに置くと、作成できました。

起きたこと

sub.example.jp のようなサブドメインの送信専用アドレスを、API(POST /mail)で作ろうとしました。所有権の確認で断られました。

{"error":{"code":"OPERATION_ERROR","message":"TXTレコードによるドメイン認証に失敗しました。"}}

先に _xserver-verify.sub.example.jp に TXT を置いて、作り直しても同じでした(その時は時間を空けて試しています)。

手順

試した順は次のとおりです。

  1. TXT を置く前に POST /mail を呼ぶ → 断られる
  2. _xserver-verify.sub.example.jp に TXT を置く → 断られる(14:45)
  3. _xserver-verify.example.jp(親ドメイン)にも同じ TXT を置く → 作成できる(15:00)
{"mail_address":"noreply@sub.example.jp","message":"メールアカウントを作成しました"}

原因

エラーの文面からは、どの名前の TXT を見ているのかが分かりません。上の順で試した結果から、サブドメインのアドレスでも親ドメインの TXT を見ていると考えました。公式の説明で確かめたわけではありません。

直し方

  • TXT は _xserver-verify.<親ドメイン> に置きます
  • 値はトークンそのままではなく xserver-verify=<トークン> の形にします
  • TXT が DNS に見えるようになってから POST /mail を呼びます。先に呼ぶと、「無い」という結果がしばらく覚えられて、TXT を足したあとも失敗が続くことがあります

確かめたこと

上の3の手順でアドレスを作成でき、そのアドレスから SMTP でメールを送って届くことを確かめました。アカウントを作り直す再現はしていないので、status はメモにしています。サブドメインの TXT を置かずに親ドメインだけで通るかどうかは、試していません。