外部DNSSECキーの設定（APIのみ）

準備

• DNS関連の書き込み権限を持つ有効な NS1 Connect APIキーが必要です。
• ゾーンでDNSSECを有効にしないと、外部DNSSECキーの設定が無視されます。

dnskey オブジェクト

APIを使用すると、1つまたは複数の外部DNSSECキーを dnskey オブジェクトとして追加することができます。このオブジェクトには、DNSKEY形式の1つまたは複数の公開鍵の詳細が含まれています。 DNSSEC キーセットの作成または変更を行うために、 PUT および POST メソッドのリクエストボディにこのオブジェクトを含めます。

ゾーン内に複数の外部DNSSECキーセットを持つことは可能ですが、1セットずつ作成する必要があります。 例えば、 NS1 Connect 以外の各プロバイダに対応する DNSSEC鍵セットを1つ作成し、そのプロバイダがゾーンデータに署名する ために使用する1つまたは複数の鍵を指定することができる。 外部DNSSECキーをグループ化する方法は、お客様次第です。

次の例は、DNSSEC 鍵のセットを作成または変更する際にリクエストボディに含める必要がある dnskey オブジェクトを示しています。

{
    "dnskey": {
        "ttl": 1200,
        "data": [
            {
                "flags": 256,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "58MeBmjs+4Ry0L+DzBCKR8Y7iQnnj9mCJBvZU7uVRYJ8htKi03lKXs6YySLDSxUMk31TgWPclYc88Z2FUDuI2Q=="
            },
            {
                "flags": 257,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "7LvMDsyZV9qy/vCzPuATbLPA5vqNmbHclp13zIDRQQiQNeBOcsS9WIaJmY+j2ZPEELz8RGq32y85K/YUgUMm2g=="
            }
        ]
    }
}

dnskey オブジェクト内で、キーセットのタイム・トゥ・ライブ（ ttl ）値（秒単位）を指定することができます。 data 配列には1つ以上のオブジェクトが含まれ、配列内の各オブジェクトは1つのDNSSECキーに対応します。 DNSSEC キーごとに、以下のパラメータを含める必要があります

外部DNSSEC鍵セットの作成

APIを使用すると、ゾーン内に1つまたは複数のDNSSEC鍵セットを作成することができます。 例えば、各DNSプロバイダーごとに1つのキーセットを作成することができます。 dnskey オブジェクトをリクエストボディに含めることに加え、以下の URL パスパラメータも指定する必要があります

次の例の PUT リクエストは、2つのDNSSECキー（つまり、 data 配列内の2つのオブジェクト）を持つ新しいDNSSECキーセットを作成します。

curl -X PUT -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/zones/{zone_name}/dnssec/external_keys/{key_set_name} -d '{
    "dnskey": {
        "ttl": 1200,
        "data": [
            {
                "flags": 256,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "58MeBmjs+4Ry0L+DzBCKR8Y7iQnnj9mCJBvZU7uVRYJ8htKi03lKXs6YySLDSxUMk31TgWPclYc88Z2FUDuI2Q=="
            },
            {
                "flags": 257,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "7LvMDsyZV9qy/vCzPuATbLPA5vqNmbHclp13zIDRQQiQNeBOcsS9WIaJmY+j2ZPEELz8RGq32y85K/YUgUMm2g=="
            }
        ]
    }
}'

NS1 Connect プラットフォーム上でDNSSECキーセットを構成した後、他のDNSプロバイダープラットフォーム内でこのプロセスを繰り返す必要がある場合があります。

外部DNSSECキーセットの詳細を表示

ゾーン内のすべてのDNSSECキーセットの詳細を表示したり、 {key_set_name} クエリパラメータを設定して、個々のキーセットの詳細を返す応答をフィルタリングすることができます。

curl -X GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/zones/{zone_name}/dnssec/external_keys/{key_set_name}

外部DNSSECキーセットを変更する

NS1 Connect APIを使用すると、外部DNSSEC鍵セットのデータを編集し、そのセット内の鍵を追加、削除、更新することができる。 ゾーン名と、 URL パスで設定した DNSSEC キーの名前を指定する。 既存のDNSSECキーセットの名前を変更することはできません。

次の例の POST リクエストは、ゾーン内の既存のDNSSECキーセットデータを変更します。

curl -X POST -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/zones/{zone_name}/dnssec/external_keys/{key_set_name} -d '{
    "dnskey": {
        "ttl": 1200,
        "data": [
            {
                "flags": 256,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "58MeBmjs+4Ry0L+DzBCKR8Y7iQnnj9mCJBvZU7uVRYJ8htKi03lKXs6YySLDSxUMk31TgWPclYc88Z2FUDuI2Q==string"
            },
            {
                "flags": 257,
                "protocol": 3,
                "algorithm": 13,
                "public_key": "7LvMDsyZV9qy/vCzPuATbLPA5vqNmbHclp13zIDRQQiQNeBOcsS9WIaJmY+j2ZPEELz8RGq32y85K/YUgUMm2g==string"
            }
        ]
    }
}'

外部DNSSECキーへの変更は即座に反映されます。

外部DNSSECキーセットを削除する

外部DNSSECキーセットを削除するには、 URL のパスにゾーン名とDNSSECキーセット名を指定します。

curl -X DELETE -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/zones/{zone_name}/external_keys/{key_set_name}