|
|
| (96 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| __TOC__
| | {{DISPLAYTITLE:Securepoint Dynamic DNS {{!}} spDYN}}{{#vardefine:headerIcon|spicon-spdyn}}<!-- |
|
| |
|
| == Was ist SPDNS? ==
| |
| SPDNS ist ein Dienst mit dem Maschinen, die nur über eine dynamische IP verfügen, per Hostname erreichbar gemacht werden können. Dadurch sind zum Beispiel Administration und VPN-Einwahl möglich, ohne dass die aktuelle IP-Adresse erst vor Ort erfragt werden muss.
| |
|
| |
|
| == Welche Rückgabecodes schickt der Server beim Update einer IP? ==
| |
| {| {{Prettytable}} cellpadding="5"
| |
| |- style="background-color:#e0e0e0;"
| |
| ! width="20%" | Rückgabecode
| |
| ! width="50%" | Erklärung
| |
| |-
| |
| |<code>abuse</code>||Der Host kann nicht aktualisiert werden, da er aufgrund vorheriger fehlerhafter Updateversuche gesperrt ist.
| |
| |-
| |
| |<code>badauth</code>||Ein ungültiger Benutzername und/oder ein ungültiges Kennwort wurde eingegeben.
| |
| |-
| |
| |<code>good</code>||Die Hostname wurde erfolgreich auf die neue IP aktualisiert.
| |
| |-
| |
| |<code>!yours</code>||Der angegebene Host kann nicht unter diesem Benutzer-Account verwendet werden.
| |
| |-
| |
| |<code>notfqdn</code>||Der angegebene Host ist kein [[Glossar#FQDN|FQDN]].
| |
| |-
| |
| |<code>numhost</code>||Es wurde versucht, mehr als 20 Hosts in einer Anfrage zu aktualisieren.
| |
| |-
| |
| |<code>nochg</code>||Die IP hat sich zum letzten Update nicht geändert. Werden innerhalb eines kurzen Zeitraumes weiterhin Updateversuche dieses Hosts vorgenommen, wird dieser für eine bestimmte Zeitspanne keine Updates mehr entgegen nehmen können.
| |
| |}
| |
|
| |
|
| == Wie lautet die Update-URL ?== | | <div class="startbox"><div class="startbox-head"> |
| | '''Thema''' |
| | </div><div class="startbox-body"> |
|
| |
|
| Die Update-URL für [https://www.spdns.de SPDNS] lautet:
| | </div></div> |
| <pre> | |
| update.spdns.de/nic/update?hostname=<domain>&myip=<ipaddr>
| |
| </pre> | |
|
| |
|
| == SPDNS-Account in einer Securepoint UTM v10 eintragen ==
| |
| {{v10}}
| |
| Die DynDNS-Einstellungen finden Sie im Menü ''Netzwerk -> Netzwerkkonfiguration -> DynDNS''. <br>
| |
| Dort haben Sie die Möglichkeit bis zu 5 DynDNS-Accounts einzutragen. <br>
| |
|
| |
|
| Eine beispielhafte Konfiguration:<br>
| |
| [[Datei:sp_utm_dyndns.png|305px|center]]
| |
|
| |
|
| == SPDNS-Account in einer Securepoint UTM v11 eintragen ==
| |
| {{v11}}
| |
| Die DynDNS-Einstellungen finden Sie im Menü "Netzwerk" -> "Netzwerk-Konfiguration". Klicken Sie dort im Tab "Schnittstellen" auf das Schraubenschlüssel-Symbol neben dem Interface, für das Sie den DynDNS-Namen konfigurieren wollen. Es öffnet sich ein neues Fenster, in dem Sie auf dem Tab "DynDNS" die entsprechenden Einstellungen vornehmen können.
| |
|
| |
|
| Eine beispielhafte Konfiguration:<br>
| | --><templatestyles src="Vorlage:Styles-Startseiten.css" /> |
| [[Datei:Dyndns-v11.png|305px|center]] | | <div class="startbox-flex"> |
| | <div class="startbox"><div class="startbox-head"> |
| | '''Konfiguration''' |
| | </div><div class="startbox-body"> |
| | * [https://spdyn.de/profile/register/ 1. Einen Account erstellen] |
| | * [https://www.spdyn.de/index/login/ 2. Mit dem Account Anmelden] |
| | * [[SPDyn/Hosthinzufügen | 3. Host hinzufügen ]] |
| | * [[ SPDyn/Hostverwenden | 4. Host verwenden ]] |
| | ** [[ SPDyn/Hostverwenden#SPDyn-Account_in_einer_Securepoint_UTM_v11_eintragen | Securepoint UTM ]] |
| | ** [[ SPDyn/Hostverwenden#Verwendung_mit_Fremdhardware | Geräte von anderen Herstellern ]] |
| | * [[ SPDyn/Hostdeaktivieren | 5. Host deaktvieren & aktivieren ]] |
| | * [[ SPDyn/Hostumziehen | 6. Host umziehen ]] |
| | * {{Hinweis|§|2020.6}} [[SPDyn/Verbindung-rsp-Konto | 7. Verbinden mit Reseller Portal Konto]] |
| | </div></div> |
|
| |
|
| == Verwendung mit Fremdhardware == | | <div class="startbox"><div class="startbox-head"> |
| === ddclient === | | '''Allgemein''' |
| ==== Geräte mit öffentlicher IP ====
| | </div><div class="startbox-body"> |
| Wenn das Gerät auf einem Interface direkt die öffentliche IP verwendet, kann die folgende Konfiguration verwendet werden:
| | * [[SPDyn/Logmeldungen | Logmeldungen von SPDyn ]] |
| <pre>
| | * [[SPDyn/meineIP | Wie ermittle ich meine öffentliche IP ]] |
| # Configuration file for ddclient generated by debconf
| | * [[SPDyn/Symbole | Symbole im SPDyn Dashboard ]] |
| #
| | * [[SPDyn/gelöschteHosts | Gelöschte Hosts]] |
| # /etc/ddclient.conf
| | * [[SPDyn/Variablen | Variablen für SPDyn]] |
| | * [[SPDyn/Rückgabecodes | SPDyn Rückgabecodes ]] |
| | * [[ SPDyn/Emailaendern | E-Mail-Adresse ändern ]] |
| | * [[ SPDyn/Updatetoken | Update-Token ]] |
| | </div></div> |
|
| |
|
| protocol=dyndns2
| | <div class="startbox"><div class="startbox-head"> |
| use=if, if=eth0
| | '''{{spc|io|o|-|c={{Farbe|gr}} }} {{#var:10 | Weitere Informationen: }}''' |
| server=update.spdns.de
| | </div><div class="startbox-body"> |
| login=$USERNAME
| | * [https://www.youtube.com/user/Securepoint10 Youtube-Channel] |
| password='$PASSWORD'
| | * [https://support.securepoint.de/viewforum.php?f=62 SPDyn Forum] |
| $HOSTNAME
| | * [https://my.securepoint.de Reseller Portal] |
| </pre>
| |
|
| |
|
| ==== Geräte in einem privaten Netz ====
| | * [https://spdyn.de/ SPDyn Website] |
| Ist der ddclient auf einem Gerät im internen Netzwerk installiert, muss die öffentliche IP vorher von einem [[SPDNS_FAQ#Wie ermittle ich meine öffentliche IP|Server im Internet]] abgefragt werden. Das kann mit der folgenden Konfiguration realisiert werden:
| | * [[SPDyn/FAQ | Securepoint Dynamic DNS FAQ]] |
| <pre> | | <div class="check"> |
| # Configuration file for ddclient generated by debconf
| | ;Support |
| #
| | * Telefonischen Support bieten wir nur für Geschäftskunden |
| # /etc/ddclient.conf
| | * Wenn Sie unser Angebot kostenlos nutzen, verwenden Sie bitte unser [https://support.securepoint.de/viewforum.php?f=62 Securepoint Support Forum] bei Anfragen. |
| | </div></div></div> |
|
| |
|
| protocol=dyndns2
| |
| use=web, web=checkip.spdns.de
| |
| server=update.spdns.de
| |
| login=$USERNAME
| |
| password='$PASSWORD'
| |
| $HOSTNAME1,$HOSTNAME2
| |
| </pre>
| |
|
| |
|
| === DDWRT ===
| | </div> |
| Eine Anleitung zur Konfiguration findet sich auf [http://fr32k.de/wiki/router/ddns_spdns fr32k.de]
| |
| | |
| === SPDNS-Account in einer AVM FRITZ!BOX eintragen ===
| |
| Die DynDNS-Einstellungen finden Sie im Menü ''Erweiterte Einstellungen -> Internet -> Freigaben -> Dynamic DNS''.<br>
| |
| Für die Verwendung des [https://www.spdns.de Securepoint Dynamic DNS Service], wählen Sie als Dynamic DNS-Anbieter "Benutzerdefiniert" aus und tragen folgende URL als Update-URL ein:
| |
| <pre>
| |
| update.spdns.de/nic/update?hostname=<domain>&myip=<ipaddr>
| |
| </pre>
| |
| '''ACHTUNG''': die spitzen Klammern sind keine Platzhalter, sondern müssen genau so eingegeben werden.
| |
| | |
| Ergänzen Sie die weiteren Felder ''Domainname'' mit Ihrem Hostname, ''Benutzername'' mit Ihrem SPDNS-Login sowie ''Kennwort'' und ''Kennwortbestätigung'' mit Ihrem SPDNS-Kennwort. <br>
| |
| | |
| Eine beispielhafte Konfiguration:<br>
| |
| [[Datei:Fritz_box_spdns.png|500px|center]]
| |
| | |
| == Wie können mehr als 5 Hosts über einen Account verwaltet werden? ==
| |
| | |
| Zunächst haben Sie die Möglichkeit bis zu 5 Hosts zu verwalten.<br>
| |
| Sind diese 5 Hosts erreicht, können Sie weitere Hosts beantragen. <br>
| |
| Klicken Sie hierfür auf den Button '''Request additional hosts'''. <br>
| |
| | |
| | |
| [[Datei:Spdns_request_additional_hosts.png|500px|center]]
| |
| | |
| ==Welche Variablen können in der Update-URL angegeben werden?==
| |
| {| {{prettytable}}
| |
| ! Parameter-Name
| |
| ! Beispiel
| |
| ! Erklärung
| |
| |-
| |
| | hostname
| |
| | <code>beispiel1.spdns.de<br />beispiel1.spdns.de,beispiel2.spdns.de</code>
| |
| | Ein einzelner FQDN oder eine komma-separierte Liste (max 20 Einträge) von FQDNs die aktualisiert werden sollen
| |
| |-
| |
| | myip
| |
| | <code>192.2.0.1</code>
| |
| | Genau eine IPv4-Adresse, mit der die Hosts aktualisiert werden sollen
| |
| |-
| |
| | user
| |
| | <code>spdnsUser1</code>
| |
| | <b>[Optional]</b> Der Name eines Benutzers, der diesen Host aktualisieren kann
| |
| |-
| |
| | pass
| |
| | <code>geheimesP4asswort</code>
| |
| | <b>[Optional]</b> Das Passwort eines Benutzers, der diesen Host aktualisieren kann
| |
| |}
| |
| | |
| *Der <code>user</code>- und <code>pass</code>-Parameter sind nur dann zu verwenden, wenn keine [http://en.wikipedia.org/wiki/Basic_access_authentication HTTP Basic-Auth] durchgeführt wird. Fehlen sowohl der <code>Authorization</code>-Header, als auch die <code>user</code>/<code>pass</code>-Kombination schlägt das Update mit dem <code>badauth</code> Return-Code fehl.
| |
| *Ein vorhandener <code>Authorization</code>-Header überschreibt evtl als Parameter übergebene Username/Passwort Kombinationen
| |
| *Befindet sich die im Parameter <code>myip</code> übergebene IP in einem privaten Subetz (10.0.0.0/8, 172.16.0.0/20 oder 192.168.0.0/16), wird das Update-Skript stattdessen die für den Verbindungsaufbau verwendete öffentliche IP zum Update verwenden.
| |
| | |
| == Wie ermittle ich meine öffentliche IP? ==
| |
| Um die öffentliche IP eines Gerätes zu vermitteln, stellen wir den Host [http://checkip.spdns.de checkip.spdns.de] zur Verfügung. Dieser ist auch erreichbar unter [http://myip.spdns.de myip.spdns.de] und [http://getip.spdns.de getip.spdns.de].
| |
| | |
| Die Ausgabe der IP erfolgt entweder als Plaintext (das ist der Standard), JSON oder XML.
| |
| | |
| === Ausgabe als JSON-Objekt ===
| |
| Beim Aufruf von [http://checkip.spdns.de/json http://checkip.spdns.de/json] werden die gefundenen IP-Adressen nach folgendem Schema mit dem MIME-Type <code>application/json</code> ausgegeben:
| |
| <pre>
| |
| {
| |
| "ipinfo":[{
| |
| "ip":"192.0.0.1",
| |
| "source":"REMOTE_ADDR"
| |
| },{
| |
| "ip":"10.0.0.1",
| |
| "source":"HTTP_X_FORWARDED_FOR"
| |
| },{
| |
| "ip":"10.0.0.2",
| |
| "source":"HTTP_X_FORWARDED_FOR"
| |
| }]
| |
| }
| |
| </pre>
| |
| | |
| === Ausgabe als XML ===
| |
| Beim Aufruf von [http://checkip.spdns.de/xml http://checkip.spdns.de/xml] werden die gefundenen IP-Adressen nach folgendem Schema mit dem MIME-Type <code>text/xml</code> ausgegeben:
| |
| <pre>
| |
| <ipinfo>
| |
| <ip ip="192.0.0.1" source="REMOTE_ADDR"/>
| |
| <ip ip="10.0.0.1" source="HTTP_X_FORWARDED_FOR"/>
| |
| <ip ip="10.0.0.2" source="HTTP_X_FORWARDED_FOR"/>
| |
| </ipinfo>
| |
| </pre> | |