本ウエブサイトをご利用の際は、ＪａｖａＳｃｒｉｐｔを有効にする必要があります。
本サービスのダイナミックＤＮＳ機能について
ダイナミックＤＮＳ機能について
ＩＰアドレスが固定ではなく、動的のホストにドメイン名を割り当てる場合、ＩＰアドレスが変わるたびにＤＮＳレコードの更新が必要となります。 ダイナミックＤＮＳ機能を利用することで、その更新を容易にすることができます。 この機能はｄｄｃｌｉｅｎｔ等のツールや一部のルータ等でも利用可能です。
本サービスのダイナミックＤＮＳ機能は RFC 2136 (Dynamic Updates in the Domain Name System) で規定されているものとは異なり、ＤＮＳレコードの更新はウエブを利用したものとなります。
利用方法
ダイナミックＤＮＳクライアントの用意
DynDNS.com に対応したツール類や機器が利用可能な場合があります。次のような環境で利用が可能です（リンク先はそれぞれの設定例です）。
ユーザ名とパスワードについて
ダイナミックＤＮＳ機能の利用には、対象のドメイン名にユーザ名とパスワードの設定が必要となります。
ＯｐｅｎＩＤでログインしてドメイン名を追加後、追加済みのドメイン名にパスワードの設定が可能となります。「ドメイン名管理」から「パスワード」の「設定」ボタンを押すと、ダイナミックＤＮＳ機能の利用に必要なユーザ名とパスワードが発行されます。
仕様について
ＡＰＩ
ダイナミックＤＮＳのＡＰＩは DynDNS.com のものを参考にしています。これにより、DynDNS.com に対応した一部の機器でも本サービスの利用が可能となっています。
ＤＮＳレコードのタイプについて
ＡＰＩではＡレコードとＡＡＡＡレコードのみの対応となります。その他のレコードはＯｐｅｎＩＤでログイン後の「ドメイン名管理」でのみ設定が可能です。
サーバへのリクエスト方法
GET リクエストとなり、その際に対象のドメイン名に設定したユーザ名とパスワードをＢａｓｉｃ認証で渡します。
ＩＰアドレスを指定して example.kendomo.jp を更新する場合、ＵＲＩは以下ようになります。
https://domain.kendomo.net/nic/update?hostname=example.kendomo.jp&myip=ＩＰアドレス
Ｂａｓｉｃ認証のユーザ名とパスワードを含めた形式のＵＲＩは以下のようになります。
https://USERNAME:PASSWORD@domain.kendomo.net/nic/update?hostname=example.kendomo.jp&myip=ＩＰアドレス
この際、myip= で指定するＩＰアドレスはＩＰｖ４形式のほか、ＩＰｖ６でも指定が可能です。ＩＰアドレスがＩＰｖ４かＩＰｖ６かは自動で識別します。ＩＰｖ４の場合はＡレコードが更新（存在しなければ追加）対象となり、ＩＰｖ６の場合はＡＡＡＡレコードが更新（存在しなければ追加）対象となります。
参考にしている DynDNS.com のＡＰＩでＡＡＡＡレコードが扱えないため、ＡＡＡＡレコードおよびＩＰｖ６アドレスへの対応は独自に実装しています。このため、将来 DynDNS.com がＡＡＡＡレコードに対応し、もしも本サービスと実装方法が異なった場合は互換性のために本サービスの仕様を変更する可能性があります。
以下のように myip= オプションを省略することもできます。この場合はこのＵＲＩへの接続元ＩＰアドレスが指定されたことになります。このとき、ＩＰｖ４で接続すればＡレコードが更新（存在しなければ追加）対象となり、ＩＰｖ６で接続すればＡＡＡＡレコードが更新（存在しなければ追加）対象となります。ただし、この際は後述のＩＰｖ６からＩＰｖ４へのフォールバックについて注意が必要となります。
https://domain.kendomo.net/nic/update?hostname=example.kendomo.jp
ＩＰｖ６からＩＰｖ４へのフォールバックについて
domain.kendomo.net というドメイン名にはＡＡＡＡレコードとＡレコードの両方が付加されているため、 ＩＰｖ６アドレスとＩＰｖ４アドレスの両方が割り当てられているクライアントでは、クライアントの実装や設定によってはＩＰｖ６を優先して接続を行います。 この際、ＩＰｖ６による通信ができなかった場合はＩＰｖ４にフォールバックすることがあります。 myip= オプションを省略することにより、domain.kendomo.net への接続ＩＰアドレスに応じてＡＡＡＡレコードまたはＡレコードが更新（存在しなければ追加）されますので、フォールバックにより予期せぬレコードが更新される恐れがあります。
リターンコード
ＡＰＩを利用した際の本サービスとＤｙｎＤＮＳ．ｃｏｍのリターンコードの一覧を以下の表にまとめます。仕様の違いにより、エラー内容によってはＤｙｎＤＮＳ．ｃｏｍとは異なるものになります。
| 動作 | 本サービス | DynDNS.com |
|---|---|---|
| アップデート成功。 | success | success |
| アップデートは不要だった。前回とＩＰアドレスに変化がない場合。 | nochg | nochg |
| ユーザ名またはパスワードの認証に失敗。 | badauth | badauth |
| 与えられたパラメタが正しくない。 | badsys | badsys |
| 提供されていないＦＱＤＮを指定した。 | badauth | notfqdn |
| 存在しないホスト名を指定した。 | badauth | nohost |
| ホスト名は存在するが、それは他のユーザのものである。 | badauth | !yours |
| 寄与したユーザだけ利用できるオプションが指定されているが、ユーザは寄与していない。 | 未定義 | !donator |
| 指定のホスト名は有効でない。 | 未定義 | !active |
| 更新の乱用（更新しすぎ）により停止されている。 | 未定義 | abuse |
| ２つ以上のホストが存在したため、エラーとなった | 未定義 | numhost |
| ＤＮＳエラー | 未定義 | dnserr |
| すでに異なるタイプのレコードの合計が最大数に達しており、新規のレコードを追加できない。 | badsys |
注意点
- ＡＰＩはＨＴＴＰＳ（ＳＳＬ）による接続が必要です。ＨＴＴＰには対応しません。
- ＨＴＴＰ／１．０を使用するＤｙｎＤＮＳ．ｃｏｍとは異なり、本サービスはＨＴＴＰ／１．１を使用するため、Host ヘッダが必須となります。古いＩＯＳのＣｉｓｃｏルータで本サービスが利用できないのは、このヘッダを正しく送出しないためのようです。なお、Ｈｏｓｔヘッダの送出さえ行えば、ＨＴＴＰ／１．０で接続しても利用は可能です。
- 対象ドメイン名のＡレコード（またはＡＡＡＡレコード）が存在していない場合、Ａレコード（またはＡＡＡＡレコード）が新規に追加されます。その際のＴＴＬは３００秒となります。
- 対象ドメイン名のＡレコード（またはＡＡＡＡレコード）がすでに存在していた場合、ＩＰアドレスが更新の対象となります。ＴＴＬは変更の対象とはなりません。ＴＴＬを長めに設定している場合はご注意ください。
- ＤＮＳラウンドロビンの利用目的でＡレコード（またはＡＡＡＡレコード）が複数存在している場合、すべてのＡレコード（またはＡＡＡＡレコード）が同じＩＰアドレスに更新されますのでご注意ください。
- 同一のクライアントから不必要に連続してＡＰＩに接続しないでください。ＩＰアドレスが頻繁に変わってしまった場合でも、１０分以上の間隔を置いていただければ幸いです。
このページの更新履歴
- 2010-08-05
- ＩＰｖ６からＩＰｖ４へのフォールバックについて追記。
- 2010-01-10
- 公開。
