Konfigurieren externer DNSSEC-Schlüssel (nur API)

Vorbereitende Schritte

• Sie müssen über einen gültigen NS1 Connect API-Schlüssel mit DNS-bezogenen Schreibrechten verfügen.
• Aktivieren Sie DNSSEC in der Zone, andernfalls wird die externe DNSSEC-Schlüsselkonfiguration ignoriert.

Das Objekt dnskey

Mit der API können Sie einen oder mehrere externe DNSSEC-Schlüssel als dnskey -Objekt hinzufügen, das Details zu einem oder mehreren öffentlichen Schlüsseln im DNSKEY-Format enthält. Fügen Sie dieses Objekt in den Textkörper der Anfrage für die Methoden PUT und POST ein, um die DNSSEC-Schlüsselsätze zu erstellen oder zu ändern.

Sie können zwar mehrere Sätze externer DNSSEC-Schlüssel innerhalb einer Zone haben, müssen aber jeweils nur einen Satz erstellen. Sie können zum Beispiel einen DNSSEC-Schlüsselsatz für jeden Anbieter erstellen, der nicht NS1 Connect ist, und einen oder mehrere Schlüssel angeben, die von diesem Anbieter zum Signieren von Zonendaten verwendet werden. Wie Sie externe DNSSEC-Schlüssel in Gruppen zusammenfassen, bleibt Ihnen überlassen.

Das folgende Beispiel zeigt das Objekt dnskey, das in den Anforderungstext aufgenommen werden muss, wenn Sie einen Satz DNSSEC-Schlüssel erstellen oder ändern.

{
    "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=="
            }
        ]
    }
}

Innerhalb des dnskey -Objekts können Sie einen Time-to-Live-Wert ( ttl ) (in Sekunden) für den Schlüsselsatz angeben. Das Array data enthält ein oder mehrere Objekte, wobei jedes Objekt im Array einem DNSSEC-Schlüssel entspricht. Für jeden DNSSEC-Schlüssel müssen Sie die folgenden Parameter angeben:

Erstellen externer DNSSEC-Schlüsselgruppen

Mit der API können Sie einen oder mehrere DNSSEC-Schlüsselsätze innerhalb einer Zone erstellen. Sie können beispielsweise einen Schlüsselsatz für jeden DNS-Anbieter erstellen. Zusätzlich zur Angabe des Objekts dnskey im Textfeld der Anfrage müssen Sie auch die folgenden Pfadparameter URL angeben:

Die folgende PUT -Anfrage erstellt einen neuen DNSSEC-Schlüsselsatz mit zwei DNSSEC-Schlüsseln (d. h. zwei Objekten innerhalb des data -Arrays).

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=="
            }
        ]
    }
}'

Nachdem Sie den DNSSEC-Schlüsselsatz auf der Plattform NS1 Connect konfiguriert haben, müssen Sie diesen Vorgang möglicherweise auf den Plattformen Ihrer anderen DNS-Anbieter wiederholen.

Externe Details des DNSSEC-Schlüsselsatzes anzeigen

Sie können Details zu allen DNSSEC-Schlüsselsätzen innerhalb einer Zone anzeigen oder den Abfrageparameter {key_set_name} festlegen, um die Antwort so zu filtern, dass Details zu einem einzelnen Schlüsselsatz zurückgegeben werden.

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

Ändern Sie externe DNSSEC-Schlüsselgruppen

Mit der API NS1 Connect können Sie externe DNSSEC-Schlüsselsatzdaten bearbeiten, indem Sie Schlüssel innerhalb dieses Satzes hinzufügen, entfernen oder aktualisieren. Geben Sie den Zonennamen und den Namen des DNSSEC-Schlüssels an, der im Pfad URL festgelegt ist. Sie können einen vorhandenen DNSSEC-Schlüssel nicht umbenennen.

Das folgende Beispiel einer POST -Anfrage ändert die vorhandenen DNSSEC-Schlüssel-Set-Daten innerhalb einer Zone.

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"
            }
        ]
    }
}'

Änderungen an den externen DNSSEC-Schlüsseln werden sofort übernommen.

Löschen eines externen DNSSEC-Schlüsselsatzes

Um einen externen DNSSEC-Schlüsselsatz zu entfernen, geben Sie den Zonennamen und den DNSSEC-Schlüsselsatznamen im Pfad URL an.

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