Chaser Zaks at 05:00, 16 August 2016

2016-08-16T05:00:53Z

← Older revision		Revision as of 22:00, 15 August 2016
Line 4:		Line 4:
	You may also want to see the [[#See_also\|other LSL DNS options]]. If this doesn't suit your needs, maybe the others will. Or maybe they will just look more appealing to you.		You may also want to see the [[#See_also\|other LSL DNS options]]. If this doesn't suit your needs, maybe the others will. Or maybe they will just look more appealing to you.

	==Summary==~~Eyy, time to fix some stuff:<br/>~~		==Summary==
	* Running on Debian Jessie x64, Written in Python 3, served off Apache, with MySQL as a database.		* Running on Debian Jessie x64, Written in Python 3, served off Apache, with MySQL as a database.
	* Supports proxying and non-proxying(via 307 Temporary Redirect and Location header).		* Supports proxying and non-proxying(via 307 Temporary Redirect and Location header).
Line 10:		Line 10:
	* XHR supported, must be enabled via headers.		* XHR supported, must be enabled via headers.
	* Made to use as little LSL code size as possible.		* Made to use as little LSL code size as possible.
			* Domains are accessible through UUID or a custom name(which is optional)

	==Documentation==		==Documentation==

Chaser Zaks at 05:00, 16 August 2016

2016-08-16T05:00:04Z

← Older revision		Revision as of 22:00, 15 August 2016
Line 4:		Line 4:
	You may also want to see the [[#See_also\|other LSL DNS options]]. If this doesn't suit your needs, maybe the others will. Or maybe they will just look more appealing to you.		You may also want to see the [[#See_also\|other LSL DNS options]]. If this doesn't suit your needs, maybe the others will. Or maybe they will just look more appealing to you.

	==Summary==		==Summary==Eyy, time to fix some stuff:<br/>
	* Running on Debian Jessie x64, Written in Python 3, served off Apache, with MySQL as a database.		* Running on Debian Jessie x64, Written in Python 3, served off Apache, with MySQL as a database.
	* Supports proxying and non-proxying(via 307 Temporary Redirect and Location header).		* Supports proxying and non-proxying(via 307 Temporary Redirect and Location header).
Line 178:		Line 178:
	* If an error occurs, the "err" object will be set. An easy way to check for this is: integer errorOccured = (llGetJsonType(res, ["err"]) != JSON_INVALID);		* If an error occurs, the "err" object will be set. An easy way to check for this is: integer errorOccured = (llGetJsonType(res, ["err"]) != JSON_INVALID);
	* Source code will be available eventually, but not right now. Not until I iron out all the bugs and comment it(It's a single wsgi script with 682 lines).		* Source code will be available eventually, but not right now. Not until I iron out all the bugs and comment it(It's a single wsgi script with 682 lines).
			* A object can only have ONE CUSTOM DOMAIN NAME, and it cannot be a UUID. UUIDs are reserved for object keys.

	==See also==		==See also==

Chaser Zaks: Created page with "Yes, I know several already exist. I wanted one with specific features and security, so I made my own. If you have any questions or concerns, or maybe an idea, shoot me a mess..."

2016-08-16T04:57:24Z

Created page with "Yes, I know several already exist. I wanted one with specific features and security, so I made my own. If you have any questions or concerns, or maybe an idea, shoot me a mess..."

New page

Yes, I know several already exist. I wanted one with specific features and security, so I made my own.
If you have any questions or concerns, or maybe an idea, shoot me a message at http://my.secondlife.com/chaser.zaks (Send me a IM, they do not get capped. I do not read the SL facebook thing.)

You may also want to see the [[#See_also|other LSL DNS options]]. If this doesn't suit your needs, maybe the others will. Or maybe they will just look more appealing to you.

==Summary==
* Running on Debian Jessie x64, Written in Python 3, served off Apache, with MySQL as a database.
* Supports proxying and non-proxying(via 307 Temporary Redirect and Location header).
* Content type overriding(Proxy mode only, allows to serve HTML from LSL scripts).
* XHR supported, must be enabled via headers.
* Made to use as little LSL code size as possible.

==Documentation==
====PUT http://lsl.softhyena.com/====
----
//Used to register a entry
<syntaxhighlight lang="javascript">{
(OPTIONAL) "domain": string address, //Still accessable from uuid.lsl.softhyena.com
(OPTIONAL) "title": string title, //Unused, used for indexing later(See flags)
(OPTIONAL) "auth": [string username, string password], //Unused, HTTP Authentication(See flags)
(OPTIONAL) "flags": integer mask, //See below
(OPTIONAL) "ttl": integer minutes, //Minutes for it to stay active, defaults to 24 hours.
"address": string LSL_Address //Address received from llRequestURL() or llRequestSecureURL()
}</syntaxhighlight>
Response:
<syntaxhighlight lang="javascript">{
"ttl": integer UTC_expire, //How long the server will allow
"address": string address //UUID address, or subdomain if specified.
}</syntaxhighlight>
 

====POST http://lsl.softhyena.com/====
----
//To update the TTL without sending extra data(preferred)
<syntaxhighlight lang="javascript">{
(OPTIONAL) "ttl": integer
}</syntaxhighlight>
Response:
<syntaxhighlight lang="javascript">{
"ttl": integer UTC_expire //How long the server will allow
}</syntaxhighlight>
 

====DELETE http://lsl.softhyena.com/====
----
//To delete a subdomain(BOTH THE UUID AND CUSTOM):
<syntaxhighlight lang="javascript">{}</syntaxhighlight>
Response:
<syntaxhighlight lang="javascript">{}</syntaxhighlight>
 

====GET http://lsl.softhyena.com/====
----
//Return info(THIS IS DIFFERENT THAN GET FROM A BROWSER):
<syntaxhighlight lang="javascript">{}</syntaxhighlight>
Response:
<syntaxhighlight lang="javascript">{
"ttl": integer UTC_expire,
"domain": string address,
"flags": integer flags,
"address": string assigned_url
}</syntaxhighlight>

==LSL Functions==
====Register a domain====
----
<syntaxhighlight lang="lsl2">key registerDomain(list params){
/*[
(OPTIONAL) "domain", string address, //Still accessable from uuid.lsl.softhyena.com
(OPTIONAL) "flags", integer mask, //See below
(OPTIONAL) "ttl", integer minutes, //Minutes for it to stay active, defaults to 24 hours.
"address", string LSL_Address //Address received from llRequestURL() or llRequestSecureURL()
]*/
return llHTTPRequest("http://lsl.softhyena.com",[HTTP_METHOD, "PUT"],llList2Json(JSON_OBJECT, params));
}</syntaxhighlight>
 
====Refresh TTL====
----
<syntaxhighlight lang="lsl2">key refreshDomain(integer ttl){
list q;
if(ttl)q=["ttl",llAbs(ttl)];
return llHTTPRequest("http://lsl.softhyena.com",[HTTP_METHOD, "POST"],llList2Json(JSON_OBJECT,q));
}</syntaxhighlight>
 
====Delete a domain====
----
<syntaxhighlight lang="lsl2">key deleteDomain(){
return llHTTPRequest("http://lsl.softhyena.com",[HTTP_METHOD, "DELETE"],"");
}</syntaxhighlight>

==Flags==
{| {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
| Domain Flags
| V
| Description
| Notes
|-
| DOMAIN_FLAG_HIDDEN
| 1
| Real URL cannot be grabbed from info
|
|-
| DOMAIN_FLAG_LSL_ONLY
| 2
| Only LSL objects can make request to this URL
| This applies to the "info." prefix as well
|-
| DOMAIN_FLAG_NO_PROXY
| 4
| Bypass our proxy and force a redirect
| May not work with post requests?
|-
| DOMAIN_FLAG_INDEX
| 8
| Used to index domains, opt-in for obvious reasons.
| Not implemented
|-
| DOMAIN_FLAG_AUTH
| 16
| Only allow authenticated requests
| Not implemented
|-
| DOMAIN_FLAG_SECURE
| 32
| Force HTTP requests to upgrade to HTTPS requests.
| No effect on HTTPS LSL URLs.
|-
| DOMAIN_FLAG_PRIVACY
| 64
| Server will strip headers sent by LL that may reveal where your server is located in world.
| Not implemented
|-
| DOMAIN_FLAG_DEBUG
| 128
| Enables various debugging headers and system logging.
| Used internally.
|}

==Added headers==
{| {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
| Header
| Description
| Example value
|-
| via
| Version of the proxy
| lsl.softhyena.com (<version number>)
|-
| x-forwarded-for
| IP address of the originating request
| 67.140.140.92
|}

==Info prefix==
====Human readable====
----
http://info.<subdomain OR uuid>.lsl.softhyena.com/
====Json====
----
http://info.<subdomain OR uuid>.lsl.softhyena.com/json
====Key/values====
----
http://info.<subdomain OR uuid>.lsl.softhyena.com/address
http://info.<subdomain OR uuid>.lsl.softhyena.com/owner
http://info.<subdomain OR uuid>.lsl.softhyena.com/owner_name (Does not work yet)
http://info.<subdomain OR uuid>.lsl.softhyena.com/ttl
http://info.<subdomain OR uuid>.lsl.softhyena.com/title
http://info.<subdomain OR uuid>.lsl.softhyena.com/flags

==Notes==
* If you give the server a secure LSL URL, you MUST use HTTPS when accessing this proxy, or you will receive an error.
* This is a free service and will remain free forever.
* The TTL for all parts of this subdomain are set to 2 minutes, so if a URL isn't working when it should, wait about 2 minutes.
* Any object you own can request a domain in use by you, but no one can take a domain you requested unless you free it or it expires.
* Domains are first come first serve, I will not free domains if you fail to keep yours.
* If an error occurs, the "err" object will be set. An easy way to check for this is: integer errorOccured = (llGetJsonType(res, ["err"]) != JSON_INVALID);
* Source code will be available eventually, but not right now. Not until I iron out all the bugs and comment it(It's a single wsgi script with 682 lines).

==See also==
* [[User:Darien_Caldwell/HTTP-DNS]] A Dynamic DNS service running on Google App Engine, ran by Darien Caldwell.
* [[Public_Object_DNS]] A dynamic DNS service using GAE, ran by Liandra Ceawlin.
* [[Silverday_ObjectDNS]] A easy to use dns-mapping-service with many configurable options (password protection, write protection, etc.) and an optional web-interface, ran by Till Stirling.

User:Chaser Zaks/lsl dns - Revision history

Chaser Zaks at 05:00, 16 August 2016

Chaser Zaks at 05:00, 16 August 2016

Chaser Zaks: Created page with "Yes, I know several already exist. I wanted one with specific features and security, so I made my own. If you have any questions or concerns, or maybe an idea, shoot me a mess..."