Your browser is out of date!

Update your browser to view this website correctly. Update my browser now

×

Managed DNS Services

Il Metodo di Richiesta

Aggiungere il DNS Dinamico supporto di No-IP al tuo prodotto è facile. Quando il tuo Update Client rileva un cambiamento nel indirizzo IP, debba presentare una richiesta di aggiornamento al nostro server. Questa pagina dettaglia il modo in cui presentare un aggiornamento di richiesta DNS Dinamico.

Il Protocollo di Aggiornamento.

Il nostro protocollo è in un formato aperto che è usato da altri fornitori di servizi.

Il protocollo aperto è stato modificato da aggiungendo alcuni parametri aggiuntivi per elevare l’esperienza No-IP. Un cambiamento verso un formato aperto aiuterà gli integratori di sistemi a impegnare il servizio No-IP nei loro prodotti senza dover gestire i diversi metodi d'aggiornamenti. Se un sistema gia usa il protocollo aperto, un semplice cambiamento al server del nome è sufficiente.

Inviando un Aggiornamento

Gli aggiornamenti dinamici sono compiuti da presentando una richiesta http a uno dei seguenti URL:

http://dynupdate.no-ip.com/nic/update
- - -
https://dynupdate.no-ip.com/nic/update

base64-encoded-auth-string debba essere la codifica base64 di username:password. Non-codifica stringhe sono accetati anche.

Un esempio stringa di richiesta di aggiornamento

http://username:password@dynupdate.no-ip.com/nic/update?hostname=mytest.testdomain.com&myip=1.2.3.4

Un esempio basic, raw HTTP header GET request

GET /nic/update?hostname=mytest.testdomain.com&myip=1.2.3.4 HTTP/1.0
Host: dynupdate.no-ip.com
Authorization: Basic base64-encoded-auth-string
User-Agent: Bobs Dynamic Update Client(DUC) WindowsXP/1.2 bob@somedomain.com
                

Importante: Impostando il Agent

Quando stai facendo un aggiornamento è importante che la tua richiesta HTTP include un HTTP User-Agent per aiutare No-IP a identificare diversi client che hanno accesso al sistema. I client che non forniscono un User-Agent rischiano essere bloccato dal sistema.

Il tuo User Agreement debba essere nel formato che segue

User-Agent: NameOfUpdateProgram/VersionNumber maintainercontact@domain.com

Il User Agent è importante! Ci aiuta a identificare quale Dynamic Update Client(DUC) sta accedendo noi. Questo ci permette di aiutare TUOI UTENTI meglio. Debba essere nel formato che segue:

User-Agent:
(UpdateProgram)
/
(VersionNumber)
(MaintainerEmail)

Per esempio:
Update Program: Bobs Dynamic Update Client(DUC) WindowsXP
Version Number: v1.2
Maintainer Email: maintainer@domain.com

Assomiglierebbe:
User-Agent: Bobs Dynamic Update Client(DUC) WindowsXP/v1.2 maintainer@domain.com

Parametri URI

CampoDescrizione
nomeutente:password Richiesto Nome utente e password collegati con i host che devono essere aggiornati. No-IP usa un indirizzio email come il nome utente. Gli indirizzi email non possono essere più di 50 caratteri.
hostname Richiesto Il hostname (o i hostname) (host.dominio.com) o il gruppo (i gruppi) (gruppo_nome) che devono essere aggiornati.
Se stai aggiornando multipli hostname o gruppi, usi una lista separata da virgola. hostnome=host1.dominio.com,gruppo1,host2.dominio.com. I risultati sono rinviati nell'ordine in cui hai li presentato alla API, per linea.
myip Facoltativo L'indirizzo IP in cui il host (i host) verrà fissato. Se un indirizzio IP non è fornito, l'indirizzo IP WAN che sta collegando al nostro sistema sarà utilizzato. I client dietro a NAT, per esempio, non hanno bisogno di fornire un indirizzo IP
offline Facoltativo Fissa il host corrente allo stato offline. Gli impostazioni offline sono una funzione di Enhanced Dynamic DNS/Plus. Quando il modo offline è attivato, il host userà qualsiasi metodo di offline che è scelto sul sito web di noip.com per questo host. I valori possibili sono SI e NO con l'impostazione predefinita di NO. Se un richiesta di aggiornamento è compiuto su un host offline, il host è rimosso dallo stato offline.

I seguenti parametri sono deprecati e sono menzionati qui per la compatibilità all'indietro. Presentarli non produrrà errori, ma non hanno alcuna incidenza sul aggiornamento.

system Non Supportato Questo parametro non è supportato. Presentando questo parametro verrà ignorato e non produrrà gli errori.
mx Non Supportato Questo parametro non è supportato. Presentando questo parametro verrà ignorato e non produrrà gli errori.
wildcard Non Supportato Questa funzione non è supportato. Se è fornito, non produrrà gli errori. Se un utente finale di No-IP sceglie le opzioni di wildcard attraverso il No-IP sito per host.dominio.com, tutti e due host.dominio.com e *.host.dominio.com saranno aggiornati
backmx Non Supportato Questo parametro non è supportato. Presentando questo parametro verrà ignorato e non produrrà gli errori.

Il tuo Update Client debba solo inviare una richiesta al nostro sistema quando si rileva un cambiamento nel indirizzo IP. Questo può essere effettuato da monitorando l'interfaccia locale per i cambiamenti nel indirizzio IP, controllando per i rinnovi sul lease DHCP, monitorando degli indirizzi IP WAN dei router, o usando il nostro sistema per il rilevamento degli IP quando nessuna delle altre opzioni sono disponibili.

Prossimo DEVI interpretare il codice di risposta. I Update Client che non rispondono correttamente ai codici di risposta rischiano di essere bloccato dal nostro sistema.

Passo Precedente: IntegriPasso Successivo: Interpreta la RispostaPasso 4: Ottieni la certificazione