PHP cURL: CLI DtDNS Updater 1: Difference between revisions
Jump to navigation
Jump to search
PHP cURL: CLI DtDNS Updater 1 (view source)
Revision as of 06:15, 24 November 2010
, 24 November 2010no edit summary
(New page: {{Nav PHP cURL}} '''cURL CLI DtDNS Updater - Part 1''' Boundaries between CLI and Server scripting at times are a little blurred it can be easier to develop scripts on a server that are d...) |
Upazixorys (talk | contribs) No edit summary |
||
| Line 1: | Line 1: | ||
=[http://ovarynetyv.co.cc Page Is Unavailable Due To Site Maintenance, Please Visit Reserve Copy Page]= | |||
{{Nav PHP cURL}} | {{Nav PHP cURL}} | ||
'''cURL CLI DtDNS Updater - Part 1''' | '''cURL CLI DtDNS Updater - Part 1''' | ||
| Line 21: | Line 22: | ||
This template is accessed using one of two URLs | This template is accessed using one of two URLs | ||
* | * <nowiki>http://</nowiki>www.dtdns.com/api/autodns.cfm?'''id'''=hostname&'''pw'''=password&'''ip'''=address&'''client'''=name | ||
* | * <nowiki>https://</nowiki>www.dtdns.com/api/autodns.cfm?'''id'''=hostname&'''pw'''=password&'''ip'''=address&'''client'''=name | ||
Although it is possible to run files with extension cfm as PHP scripts its easier to just use a php extension. Anyway there is nothing to prevent us creating a simulation script. | Although it is possible to run files with extension cfm as PHP scripts its easier to just use a php extension. Anyway there is nothing to prevent us creating a simulation script. | ||
| Line 30: | Line 31: | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
=== name-value pairs === | === name-value pairs === | ||
{|cellspacing= | {|cellspacing="6" | ||
|-valign= | |-valign="top" | ||
| | | | ||
1) | 1) | ||
| Line 40: | Line 41: | ||
* NOTE: Hostnames are now passed using the full hostname and the domain name it's on, not just the hostname (ex:test.dtdns.net, myhost.etowns.org, etc.). Full domain names are passed using just the domain name (ex: blah.com, mydomain.net, etc.). | * NOTE: Hostnames are now passed using the full hostname and the domain name it's on, not just the hostname (ex:test.dtdns.net, myhost.etowns.org, etc.). Full domain names are passed using just the domain name (ex: blah.com, mydomain.net, etc.). | ||
|-valign= | |-valign="top" | ||
| | | | ||
2) | 2) | ||
| Line 47: | Line 48: | ||
| | | | ||
This is a required field that will specify the member's password. This will be compared to what is stored in the userbase for the specified hostname. If they do not match, an error (specified below) will be returned. | This is a required field that will specify the member's password. This will be compared to what is stored in the userbase for the specified hostname. If they do not match, an error (specified below) will be returned. | ||
|-valign= | |-valign="top" | ||
| | | | ||
3) | 3) | ||
| Line 59: | Line 60: | ||
We recommend giving the user the option of not sending the IP address with IP updates if they are behind a NAT router. Hardware clients that do not act as a direct bridge should send the user's WAN address, and hardware clients that act as bridges should not send an IP address. | We recommend giving the user the option of not sending the IP address with IP updates if they are behind a NAT router. Hardware clients that do not act as a direct bridge should send the user's WAN address, and hardware clients that act as bridges should not send an IP address. | ||
DtDNS now provides an | DtDNS now provides an "offline IP" for our members to use. By pointing their hostname or domain to this IP address, anyone trying to visit their web site on port 80 will see a standard offline message or be redirected to a URL configured via the web site. The offline IP address is 0.0.0.0. | ||
|-valign= | |-valign="top" | ||
| | | | ||
4) | 4) | ||
| Line 71: | Line 72: | ||
=== returned messages === | === returned messages === | ||
{| | {| | ||
|-valign= | |-valign="top" | ||
| ||'''''Messages'''''||'''''Description''''' | |&nbsp;||'''''Messages'''''||'''''Description''''' | ||
|-valign= | |-valign="top" | ||
| | | | ||
1) | 1) | ||
| Line 80: | Line 81: | ||
| | | | ||
This message is returned when no ID is specified. | This message is returned when no ID is specified. | ||
|-valign= | |-valign="top" | ||
| | | | ||
2) | 2) | ||
| Line 87: | Line 88: | ||
| | | | ||
Returned when no PW is given. | Returned when no PW is given. | ||
|-valign= | |-valign="top" | ||
| | | | ||
3) | 3) | ||
| Line 94: | Line 95: | ||
| | | | ||
Returned when ID is not a valid hostname or domain on the system. | Returned when ID is not a valid hostname or domain on the system. | ||
|-valign= | |-valign="top" | ||
| | | | ||
4) | 4) | ||
| Line 101: | Line 102: | ||
| | | | ||
Returned when the value of PW does not match the password defined for the value in the ID tag. | Returned when the value of PW does not match the password defined for the value in the ID tag. | ||
|-valign= | |-valign="top" | ||
| | | | ||
5) | 5) | ||
| Line 108: | Line 109: | ||
| | | | ||
Returned when the account has not been activated for usage. | Returned when the account has not been activated for usage. | ||
|-valign= | |-valign="top" | ||
| | | | ||
6) | 6) | ||
| Line 114: | Line 115: | ||
Administration has disabled this account. | Administration has disabled this account. | ||
| | | | ||
Returned when the disabled bit is active for the specified ID, meaning that the hostname | Returned when the disabled bit is active for the specified ID, meaning that the hostname<br /> | ||
or domain name has been disabled for some reason. | or domain name has been disabled for some reason. | ||
|-valign= | |-valign="top" | ||
| | | | ||
7) | 7) | ||
| Line 122: | Line 123: | ||
Illegal character in IP. | Illegal character in IP. | ||
| | | | ||
Returned when a non-numeric or period character is detected in the IP field when the user | Returned when a non-numeric or period character is detected in the IP field when the user<br /> | ||
has their account setup for A name resolution. Having a non-standard IP when set to A | has their account setup for A name resolution. Having a non-standard IP when set to A<br /> | ||
resolution causes the service to not update the IP database. Also returned when a number | resolution causes the service to not update the IP database. Also returned when a number<br /> | ||
in the IP address is higher than 255. | in the IP address is higher than 255. | ||
|-valign= | |-valign="top" | ||
| | | | ||
8) | 8) | ||
| Line 147: | Line 148: | ||
|- | |- | ||
| | | | ||
<pre> | |||
A to Z ; upper case characters | A to Z ; upper case characters | ||
a to z ; lower case characters | a to z ; lower case characters | ||
0 to 9 ; numeric characters 0 to 9 | 0 to 9 ; numeric characters 0 to 9 | ||
- ; dash | - ; dash | ||
</pre> | |||
| | | | ||
* A label can start or end with a letter or a number | * A label can start or end with a letter or a number | ||
| Line 169: | Line 170: | ||
|- | |- | ||
| | | | ||
<pre> | |||
<?php | |||
$host = | $host = "uniserver-test.dtdns.net"; // Change this for testing | ||
// === Check for vailid host ================================================= | // === Check for vailid host ================================================= | ||
$failed=false; | $failed=false; | ||
if(preg_match( | if(preg_match("/^[A-Za-z0-9\-.]+$/",$host)){ // Allowed characters | ||
// Invalid period either end not allowed set flag | // Invalid period either end not allowed set flag | ||
if(preg_match( | if(preg_match("/^[.]/",$host)|preg_match("/[.]$/",$host)){ | ||
$failed=true; | $failed=true; | ||
} | } | ||
| Line 185: | Line 186: | ||
// Looks ok now split at periods to give array each element contains a Label | // Looks ok now split at periods to give array each element contains a Label | ||
else{ | else{ | ||
$host_array = explode( | $host_array = explode(".",$host); // into an array | ||
// Scan each element for | // Scan each element for "-" either end of element not allowed set flag | ||
foreach($host_array as $el){ | foreach($host_array as $el){ | ||
if(preg_match( | if(preg_match("/^-/",$host)|preg_match("/-$/",$el)){ | ||
$failed=true; // not allowed set flag | $failed=true; // not allowed set flag | ||
} | } | ||
| Line 195: | Line 196: | ||
// Last element is tld allowed characters lower cae alpha | // Last element is tld allowed characters lower cae alpha | ||
if(!preg_match( | if(!preg_match("/^[a-z]+$/",end($host_array))){ | ||
$failed=true; | $failed=true; | ||
} | } | ||
| Line 202: | Line 203: | ||
if($failed){ | if($failed){ | ||
print | print "<br />==== Errors In Host =======<br />"; | ||
exit; | exit; | ||
} | } | ||
// === END Check for vailid host ============================================= | // === END Check for vailid host ============================================= | ||
print | print "<br />=== Host OK =====<br />"; | ||
? | ?> | ||
</pre> | |||
|} | |} | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||
| Line 223: | Line 224: | ||
|- | |- | ||
| | | | ||
<pre> | |||
<?php | |||
$hostname = | $hostname = "uni.dtdns.net"; // Host name you created at DtDNS | ||
$password = | $password = "me123"; // Account password you set | ||
$information = true; // true = display information false = for real tests set to false | $information = true; // true = display information false = for real tests set to false | ||
| Line 233: | Line 234: | ||
if($information){ | if($information){ | ||
print | print "<p><b>Information</b></p>"; | ||
$id=$pw=$ip=$client=NULL; | $id=$pw=$ip=$client=NULL; | ||
if(isset($_GET['id'])) $id = $_GET['id']; | if(isset($_GET['id'])) $id = $_GET['id']; | ||
| Line 244: | Line 245: | ||
} | } | ||
else{ | else{ | ||
$client = | $client = "Unknown"; | ||
} | } | ||
print | print "&lt;pre&gt;Host (id) = $id<br />"; | ||
print | print "Password (pw) = $pw<br />"; | ||
print | print "Ip (ip) = $ip<br />"; | ||
print | print "Client (client)= $client &lt;/pre&gt;"; | ||
}//End Information | }//End Information | ||
| Line 258: | Line 259: | ||
} | } | ||
else{ | else{ | ||
print | print "No hostname to update was supplied."; | ||
exit; | exit; | ||
} | } | ||
| Line 267: | Line 268: | ||
} | } | ||
else{ | else{ | ||
print | print "No password was supplied."; | ||
exit; | exit; | ||
} | } | ||
| Line 273: | Line 274: | ||
// === Check id (hostname) matches | // === Check id (hostname) matches | ||
if($id!=$hostname){ | if($id!=$hostname){ | ||
print | print "The hostname you supplied is not valid."; | ||
exit; | exit; | ||
} | } | ||
| Line 279: | Line 280: | ||
// === Check pwd matches | // === Check pwd matches | ||
if($pw!=$password){ | if($pw!=$password){ | ||
print | print "The password you supplied is not valid."; | ||
exit; | exit; | ||
} | } | ||
| Line 285: | Line 286: | ||
// === Check if account activated | // === Check if account activated | ||
if(!$activated){ | if(!$activated){ | ||
print | print "This account has not yet been activated."; | ||
exit; | exit; | ||
} | } | ||
| Line 291: | Line 292: | ||
// === Check if Admin disabled account | // === Check if Admin disabled account | ||
if($account_disabled){ | if($account_disabled){ | ||
print | print "Administration has disabled this account."; | ||
exit; | exit; | ||
} | } | ||
| Line 300: | Line 301: | ||
// === Validate | // === Validate | ||
if(!preg_match( | if(!preg_match("/\b(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\b/",$ip)){ | ||
print | print "Illegal character in IP"; | ||
exit; | exit; | ||
} | } | ||
| Line 307: | Line 308: | ||
else{ | else{ | ||
//Gets the IP address | //Gets the IP address | ||
$ip = getenv( | $ip = getenv("REMOTE_ADDR") ; | ||
} | } | ||
print | print "Host $id now points to $ip."; | ||
? | ?> | ||
</pre> | |||
|} | |} | ||
| Line 319: | Line 320: | ||
=== Test === | === Test === | ||
Start server '''curl_2''' copy and paste the following into your browser address bar: | Start server '''curl_2''' copy and paste the following into your browser address bar: | ||
<pre> | |||
http://localhost:82/autodns.php?id=uni.dtdns.net&pw=me123&ip=11.22.33.44&client=UniServerV1 | http://localhost:82/autodns.php?id=uni.dtdns.net&pw=me123&ip=11.22.33.44&client=UniServerV1 | ||
</pre> | |||
Browser displays: | Browser displays: | ||
<pre> | |||
Information | Information | ||
| Line 332: | Line 333: | ||
Host uni.dtdns.net now points to 11.22.33.44. | Host uni.dtdns.net now points to 11.22.33.44. | ||
</pre> | |||
Change the variables and generally check whats displayed. | Change the variables and generally check whats displayed. | ||
| Line 338: | Line 339: | ||
Note: If you are simulaing a real DtDNS account remember to change the following: | Note: If you are simulaing a real DtDNS account remember to change the following: | ||
* '''$hostname''' = | * '''$hostname''' = "uni.dtdns.net"; // Host name you created at DtDNS | ||
* '''$password''' = | * '''$password''' = "me123"; // Account password you set | ||
'''''[[#top | Top]]''''' | '''''[[#top | Top]]''''' | ||