Adam Ierymenko
9 years ago
3 changed files with 577 additions and 75 deletions
@ -0,0 +1,546 @@ |
|||||||
|
/* |
||||||
|
* A JavaScript class based model for the ZeroTier controller microservice API |
||||||
|
* Copyright (C) 2011-2017 ZeroTier, Inc. https://www.zerotier.com/
|
||||||
|
* |
||||||
|
* This program is free software: you can redistribute it and/or modify |
||||||
|
* it under the terms of the GNU General Public License as published by |
||||||
|
* the Free Software Foundation, either version 3 of the License, or |
||||||
|
* (at your option) any later version. |
||||||
|
* |
||||||
|
* This program is distributed in the hope that it will be useful, |
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||||
|
* GNU General Public License for more details. |
||||||
|
* |
||||||
|
* You should have received a copy of the GNU General Public License |
||||||
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
* |
||||||
|
* -- |
||||||
|
* |
||||||
|
* You can be released from the requirements of the license by purchasing |
||||||
|
* a commercial license. Buying such a license is mandatory as soon as you |
||||||
|
* develop commercial closed-source software that incorporates or links |
||||||
|
* directly against ZeroTier software without disclosing the source code |
||||||
|
* of your own application. |
||||||
|
*/ |
||||||
|
|
||||||
|
'use strict'; |
||||||
|
|
||||||
|
/** |
||||||
|
* Goes through a rule set array and makes sure it's valid, returning a canonicalized version |
||||||
|
* |
||||||
|
* @param {array[object]} rules Array of ZeroTier rules |
||||||
|
* @return New array of canonicalized rules |
||||||
|
* @throws {Error} Rule set is invalid |
||||||
|
*/ |
||||||
|
function formatRuleSetArray(rules) |
||||||
|
{ |
||||||
|
} |
||||||
|
exports.formatRuleSetArray = formatRuleSetArray; |
||||||
|
|
||||||
|
/** |
||||||
|
* @param {string} IP with optional /netmask|port section |
||||||
|
* @return 4, 6, or 0 if invalid |
||||||
|
*/ |
||||||
|
function ipClassify(ip) |
||||||
|
{ |
||||||
|
if ((!ip)||(typeof ip !== 'string')) |
||||||
|
return 0; |
||||||
|
let ips = ip.split('/'); |
||||||
|
if (ips.length > 0) { |
||||||
|
if (ips.length > 1) { |
||||||
|
if (ips[1].length === 0) |
||||||
|
return 0; |
||||||
|
for(let i=0;i<ips[1].length;++i) { |
||||||
|
if ('0123456789'.indexOf(ips[1].charAt(i)) < 0) |
||||||
|
return 0; |
||||||
|
} |
||||||
|
} |
||||||
|
if (ips[0].indexOf(':') > 0) { |
||||||
|
for(let i=0;i<ips[0].length;++i) { |
||||||
|
if ('0123456789abcdefABCDEF:'.indexOf(ips[0].charAt(i)) < 0) |
||||||
|
return 0; |
||||||
|
} |
||||||
|
return 6; |
||||||
|
} else if (ips[0].indexOf('.') > 0) { |
||||||
|
for(let i=0;i<ips[0].length;++i) { |
||||||
|
if ('0123456789.'.indexOf(ips[0].charAt(i)) < 0) |
||||||
|
return 0; |
||||||
|
} |
||||||
|
return 4; |
||||||
|
} |
||||||
|
} |
||||||
|
return 0; |
||||||
|
} |
||||||
|
exports.ipClassify = ipClassify; |
||||||
|
|
||||||
|
/** |
||||||
|
* Make sure a string is lower case hex and optionally left pad |
||||||
|
* |
||||||
|
* @param x {string} String to format/canonicalize |
||||||
|
* @param l {number} Length of desired string or 0/null to not left pad |
||||||
|
* @return Padded string |
||||||
|
*/ |
||||||
|
function formatZeroTierIdentifier(x,l) |
||||||
|
{ |
||||||
|
x = (x) ? x.toString().toLowerCase() : ''; |
||||||
|
l = ((typeof l !== 'number')||(l < 0)) ? 0 : l; |
||||||
|
|
||||||
|
let r = ''; |
||||||
|
for(let i=0;i<x.length;++i) { |
||||||
|
let c = x.charAt(i); |
||||||
|
if ('0123456789abcdef'.indexOf(c) >= 0) { |
||||||
|
r += c; |
||||||
|
if (r.length === l) |
||||||
|
break; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
while (r.length < l) |
||||||
|
r = '0' + r; |
||||||
|
|
||||||
|
return r; |
||||||
|
}; |
||||||
|
exports.formatZeroTierIdentifier = formatZeroTierIdentifier; |
||||||
|
|
||||||
|
// Internal container classes
|
||||||
|
class _V4AssignMode |
||||||
|
{ |
||||||
|
get zt() { return (this._zt)||false; } |
||||||
|
set zt(b) { this._zt = !!b; } |
||||||
|
toJSON() |
||||||
|
{ |
||||||
|
return { zt: this.zt }; |
||||||
|
} |
||||||
|
}; |
||||||
|
class _v6AssignMode |
||||||
|
{ |
||||||
|
get ['6plane'] { return (this._6plane)||false; } |
||||||
|
set ['6plane'](b) { this._6plane = !!b; } |
||||||
|
get zt() { return (this._zt)||false; } |
||||||
|
set zt(b) { this._zt = !!b; } |
||||||
|
get rfc4193() { return (this._rfc4193)||false; } |
||||||
|
set rfc4193(b) { this._rfc4193 = !!b; } |
||||||
|
toJSON() |
||||||
|
{ |
||||||
|
return { |
||||||
|
zt: this.zt, |
||||||
|
rfc4193: this.rfc4193, |
||||||
|
'6plane': this['6plane'] |
||||||
|
}; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
class Network |
||||||
|
{ |
||||||
|
constructor(obj) |
||||||
|
{ |
||||||
|
this.clear(); |
||||||
|
this.patch(obj); |
||||||
|
} |
||||||
|
|
||||||
|
get objtype() { return 'network'; } |
||||||
|
|
||||||
|
get id() { return this._id; } |
||||||
|
set id(x) { return (this._id = formatZeroTierIdentifier(x,16)); } |
||||||
|
|
||||||
|
get nwid() { return this._id; } // legacy
|
||||||
|
|
||||||
|
get authTokens() { return this._authTokens; } |
||||||
|
set authTokens(at) |
||||||
|
{ |
||||||
|
this._authTokens = {}; |
||||||
|
if ((at)&&(typeof at === 'object')&&(!Array.isArray(at))) { |
||||||
|
for(let k in at) { |
||||||
|
let exp = parseInt(at[k])||0; |
||||||
|
if (exp >= 0) |
||||||
|
this._authTokens[k] = exp; |
||||||
|
} |
||||||
|
} |
||||||
|
return this._authTokens; |
||||||
|
} |
||||||
|
|
||||||
|
get capabilities() { return this._capabilities; } |
||||||
|
set capabilities(c) |
||||||
|
{ |
||||||
|
let ca = []; |
||||||
|
let ids = {}; |
||||||
|
if ((c)&&(Array.isArray(c))) { |
||||||
|
for(let a=0;a<c.length;++a) { |
||||||
|
let cap = c[a]; |
||||||
|
if ((cap)&&(typeof cap === 'object')&&(!Array.isArray(cap))) { |
||||||
|
let capId = parseInt(cap.id)||-1; |
||||||
|
if ((capId >= 0)&&(capId <= 0xffffffff)&&(!ids[capId])) { |
||||||
|
ids[capId] = true; |
||||||
|
let capDefault = !!cap['default']; |
||||||
|
let capRules = formatRuleSetArray(cap.rules); |
||||||
|
ca.push({ |
||||||
|
id: capId, |
||||||
|
'default': capDefault, |
||||||
|
rules: capRules |
||||||
|
}); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
ca.sort(function(a,b) { |
||||||
|
a = a.id; |
||||||
|
b = b.id; |
||||||
|
return ((a > b) ? 1 : ((a < b) ? -1 : 0)); |
||||||
|
}); |
||||||
|
this._capabilities = ca; |
||||||
|
return ca; |
||||||
|
} |
||||||
|
|
||||||
|
get ipAssignmentPools() return { this._ipAssignmentPools; } |
||||||
|
set ipAssignmentPools(ipp) |
||||||
|
{ |
||||||
|
let pa = []; |
||||||
|
let ranges = {}; |
||||||
|
if ((ipp)&&(Array.isArray(ipp))) { |
||||||
|
for(let a=0;a<ipp.length;++a) { |
||||||
|
let range = ipp[a]; |
||||||
|
if ((range)&&(typeof range === 'object')&&(!Array.isArray(range))) { |
||||||
|
let start = range.ipRangeStart; |
||||||
|
let end = range.ipRangeEnd; |
||||||
|
if ((start)&&(end)) { |
||||||
|
let stype = ipClassify(start); |
||||||
|
if ((stype > 0)&&(stype === ipClassify(end))&&(!ranges[start+'_'+end])) { |
||||||
|
ranges[start+'_'+end] = true; |
||||||
|
pa.push({ ipRangeStart: start, ipRangeEnd: end }); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
pa.sort(function(a,b) { return a.ipRangeStart.localeCompare(b.ipRangeStart); }); |
||||||
|
this._ipAssignmentPools = pa; |
||||||
|
return pa; |
||||||
|
} |
||||||
|
|
||||||
|
get multicastLimit() return { this._multicastLimit; } |
||||||
|
set multicastLimit(n) |
||||||
|
{ |
||||||
|
try { |
||||||
|
let nn = parseInt(n)||0; |
||||||
|
this._multicastLimit = (nn >= 0) ? nn : 0; |
||||||
|
} catch (e) { |
||||||
|
this._multicastLimit = 0; |
||||||
|
} |
||||||
|
return this._multicastLimit; |
||||||
|
} |
||||||
|
|
||||||
|
get routes() return { this._routes; } |
||||||
|
set routes(r) |
||||||
|
{ |
||||||
|
let ra = []; |
||||||
|
let targets = {}; |
||||||
|
if ((r)&&(Array.isArray(r))) { |
||||||
|
for(let a=0;a<r.length;++a) { |
||||||
|
let route = r[a]; |
||||||
|
if ((route)&&(typeof route === 'object')&&(!Array.isArray(route))) { |
||||||
|
let routeTarget = route.target; |
||||||
|
let routeVia = route.via||null; |
||||||
|
let rtt = ipClassify(routeTarget); |
||||||
|
if ((rtt > 0)&&((routeVia === null)||(ipClassify(routeVia) === rtt))&&(!targets[routeTarget])) { |
||||||
|
targets[routeTarget] = true; |
||||||
|
ra.push({ target: routeTarget, via: routeVia }); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
ra.sort(function(a,b) { return a.routeTarget.localeCompare(b.routeTarget); }); |
||||||
|
this._routes = ra; |
||||||
|
return ra; |
||||||
|
} |
||||||
|
|
||||||
|
get tags() return { this._tags; } |
||||||
|
set tags(t) |
||||||
|
{ |
||||||
|
let ta = []; |
||||||
|
if ((t)&&(Array.isArray(t))) { |
||||||
|
for(let a=0;a<t.length;++a) { |
||||||
|
let tag = t[a]; |
||||||
|
if ((tag)&&(typeof tag === 'object')&&(!Array.isArray(tag))) { |
||||||
|
let tagId = parseInt(tag.id)||-1; |
||||||
|
if ((tagId >= 0)||(tagId <= 0xffffffff)) { |
||||||
|
let tagDefault = tag.default; |
||||||
|
if (typeof tagDefault !== 'number') |
||||||
|
tagDefault = parseInt(tagDefault)||null; |
||||||
|
if ((tagDefault < 0)||(tagDefault > 0xffffffff)) |
||||||
|
tagDefault = null; |
||||||
|
ta.push({ 'id': tagId, 'default': tagDefault }); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
ta.sort(function(a,b) { |
||||||
|
a = a.id; |
||||||
|
b = b.id; |
||||||
|
return ((a > b) ? 1 : ((a < b) ? -1 : 0)); |
||||||
|
}); |
||||||
|
this._tags = ta; |
||||||
|
return ta; |
||||||
|
} |
||||||
|
|
||||||
|
get v4AssignMode() return { this._v4AssignMode; } |
||||||
|
set v4AssignMode(m) |
||||||
|
{ |
||||||
|
if ((m)&&(typeof m === 'object')&&(!Array.isArray(m))) { |
||||||
|
this._v4AssignMode.zt = m.zt; |
||||||
|
} else if (m === 'zt') { // legacy
|
||||||
|
this._v4AssignMode.zt = true; |
||||||
|
} else { |
||||||
|
this._v4AssignMode.zt = false; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
get v6AssignMode() return { this._v6AssignMode; } |
||||||
|
set v6AssignMode(m) |
||||||
|
{ |
||||||
|
if ((m)&&(typeof m === 'object')&&(!Array.isArray(m))) { |
||||||
|
this._v6AssignMode.zt = m.zt; |
||||||
|
this._v6AssignMode.rfc4193 = m.rfc4193; |
||||||
|
this._v6AssignMode['6plane'] = m['6plane']; |
||||||
|
} else if (typeof m === 'string') { // legacy
|
||||||
|
let ms = m.split(','); |
||||||
|
this._v6AssignMode.zt = false; |
||||||
|
this._v6AssignMode.rfc4193 = false; |
||||||
|
this._v6AssignMode['6plane'] = false; |
||||||
|
for(let i=0;i<ms.length;++i) { |
||||||
|
switch(ms[i]) { |
||||||
|
case 'zt': |
||||||
|
this._v6AssignMode.zt = true; |
||||||
|
break; |
||||||
|
case 'rfc4193': |
||||||
|
this._v6AssignMode.rfc4193 = true; |
||||||
|
break; |
||||||
|
case '6plane': |
||||||
|
this._v6AssignMode['6plane'] = true; |
||||||
|
break; |
||||||
|
} |
||||||
|
} |
||||||
|
} else { |
||||||
|
this._v6AssignMode.zt = false; |
||||||
|
this._v6AssignMode.rfc4193 = false; |
||||||
|
this._v6AssignMode['6plane'] = false; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
get rules() { return this._rules; } |
||||||
|
set rules(r) { this._rules = formatRuleSetArray(r); } |
||||||
|
|
||||||
|
get enableBroadcast() { return this._enableBroadcast; } |
||||||
|
set enableBroadcast(b) { this._enableBroadcast = !!b; } |
||||||
|
|
||||||
|
get mtu() { return this._mtu; } |
||||||
|
set mtu(n) |
||||||
|
{ |
||||||
|
let mtu = parseInt(n)||0; |
||||||
|
if (mtu <= 1280) mtu = 1280; // minimum as per IPv6 spec
|
||||||
|
if (mtu >= 10000) mtu = 10000; // maximum as per ZT spec
|
||||||
|
this._mtu = mtu; |
||||||
|
} |
||||||
|
|
||||||
|
get name() { return this._name; } |
||||||
|
set name(n) |
||||||
|
{ |
||||||
|
if (typeof n === 'string') |
||||||
|
this._name = n; |
||||||
|
else if (typeof n === 'number') |
||||||
|
this._name = n.toString(); |
||||||
|
else this._name = ''; |
||||||
|
} |
||||||
|
|
||||||
|
get private() { return this._private; } |
||||||
|
set private(b) |
||||||
|
{ |
||||||
|
// This is really meaningful for security, so make true unless explicitly set to false.
|
||||||
|
this._private = (b !== false); |
||||||
|
} |
||||||
|
|
||||||
|
get activeMemberCount() { return this.__activeMemberCount; } |
||||||
|
get authorizedMemberCount() { return this.__authorizedMemberCount; } |
||||||
|
get totalMemberCount() { return this.__totalMemberCount; } |
||||||
|
get clock() { return this.__clock; } |
||||||
|
get creationTime() { return this.__creationTime; } |
||||||
|
get revision() { return this.__revision; } |
||||||
|
|
||||||
|
toJSONExcludeControllerGenerated() |
||||||
|
{ |
||||||
|
return { |
||||||
|
id: this.id, |
||||||
|
objtype: 'network', |
||||||
|
nwid: this.nwid, |
||||||
|
authTokens: this.authTokens, |
||||||
|
capabilities: this.capabilities, |
||||||
|
ipAssignmentPools: this.ipAssignmentPools, |
||||||
|
multicastLimit: this.multicastLimit, |
||||||
|
routes: this.routes, |
||||||
|
tags: this.tags, |
||||||
|
v4AssignMode: this._v4AssignMode.toJSON(), |
||||||
|
v6AssignMode: this._v6AssignMode.toJSON(), |
||||||
|
rules: this.rules, |
||||||
|
enableBroadcast: this.enableBroadcast, |
||||||
|
mtu: this.mtu, |
||||||
|
name: this.name, |
||||||
|
'private': this['private'] |
||||||
|
}; |
||||||
|
} |
||||||
|
|
||||||
|
toJSON() |
||||||
|
{ |
||||||
|
var j = this.toJSONExcludeControllerGenerated(); |
||||||
|
j.activeMemberCount = this.activeMemberCount; |
||||||
|
j.authorizedMemberCount = this.authorizedMemberCount; |
||||||
|
j.totalMemberCount = this.totalMemberCount; |
||||||
|
j.clock = this.clock; |
||||||
|
j.creationTime = this.creationTime; |
||||||
|
j.revision = this.revision; |
||||||
|
return j; |
||||||
|
} |
||||||
|
|
||||||
|
clear() |
||||||
|
{ |
||||||
|
this._id = ''; |
||||||
|
this._authTokens = {}; |
||||||
|
this._capabilities = []; |
||||||
|
this._ipAssignmentPools = []; |
||||||
|
this._multicastLimit = 32; |
||||||
|
this._routes = []; |
||||||
|
this._tags = []; |
||||||
|
this._v4AssignMode = new _V4AssignMode(); |
||||||
|
this._v6AssignMode = new _v6AssignMode(); |
||||||
|
this._rules = []; |
||||||
|
this._enableBroadcast = true; |
||||||
|
this._mtu = 2800; |
||||||
|
this._name = ''; |
||||||
|
this._private = true; |
||||||
|
|
||||||
|
this.__activeMemberCount = 0; |
||||||
|
this.__authorizedMemberCount = 0; |
||||||
|
this.__totalMemberCount = 0; |
||||||
|
this.__clock = 0; |
||||||
|
this.__creationTime = 0; |
||||||
|
this.__revision = 0; |
||||||
|
} |
||||||
|
|
||||||
|
patch(obj) |
||||||
|
{ |
||||||
|
if (obj instanceof Network) |
||||||
|
obj = obj.toJSON(); |
||||||
|
if ((obj)&&(typeof obj === 'object')&&(!Array.isArray(obj))) { |
||||||
|
for(var k in obj) { |
||||||
|
try { |
||||||
|
switch(k) { |
||||||
|
case 'id': |
||||||
|
case 'authTokens': |
||||||
|
case 'capabilities': |
||||||
|
case 'ipAssignmentPools': |
||||||
|
case 'multicastLimit': |
||||||
|
case 'routes': |
||||||
|
case 'tags': |
||||||
|
case 'rules': |
||||||
|
case 'enableBroadcast': |
||||||
|
case 'mtu': |
||||||
|
case 'name': |
||||||
|
case 'private': |
||||||
|
case 'v4AssignMode': |
||||||
|
case 'v6AssignMode': |
||||||
|
this[k] = obj[k]; |
||||||
|
break; |
||||||
|
|
||||||
|
case 'activeMemberCount': |
||||||
|
case 'authorizedMemberCount': |
||||||
|
case 'totalMemberCount': |
||||||
|
case 'clock': |
||||||
|
case 'creationTime': |
||||||
|
case 'revision': |
||||||
|
this['__'+k] = parseInt(obj[k])||0; |
||||||
|
break; |
||||||
|
} |
||||||
|
} catch (e) {} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
}; |
||||||
|
exports.Network = Network; |
||||||
|
|
||||||
|
class Member |
||||||
|
{ |
||||||
|
constructor(obj) |
||||||
|
{ |
||||||
|
this.clear(); |
||||||
|
this.patch(obj); |
||||||
|
} |
||||||
|
|
||||||
|
get objtype() { return 'member'; } |
||||||
|
|
||||||
|
get id() { return this._id; } |
||||||
|
set id(x) { this._id = formatZeroTierIdentifier((typeof x === 'number') ? x.toString(16) : x,10); } |
||||||
|
|
||||||
|
get address() { return this._id; } // legacy
|
||||||
|
|
||||||
|
get nwid() { return this._nwid; } |
||||||
|
set nwid(x) { this._nwid = formatZeroTierIdentifier(x,16); } |
||||||
|
|
||||||
|
get controllerId() { return this.nwid.substr(0,10); } |
||||||
|
|
||||||
|
get authorized() { return this._authorized; } |
||||||
|
set authorized(b) { this._authorized = (b === true); } // security critical so require explicit set to true
|
||||||
|
|
||||||
|
get activeBridge() { return this._activeBridge; } |
||||||
|
set activeBridge(b) { this._activeBridge = !!b; } |
||||||
|
|
||||||
|
get capabilities() { return this._capabilities; } |
||||||
|
set capabilities(c) |
||||||
|
{ |
||||||
|
} |
||||||
|
|
||||||
|
get identity() { return this._identity; } |
||||||
|
set identity(istr) |
||||||
|
{ |
||||||
|
if ((istr)&&(typeof istr === 'string')) |
||||||
|
this._identity = istr; |
||||||
|
else this._identity = null; |
||||||
|
} |
||||||
|
|
||||||
|
get ipAssignments() { return this._ipAssignments; } |
||||||
|
set ipAssignments(ipa) |
||||||
|
{ |
||||||
|
} |
||||||
|
|
||||||
|
get noAutoAssignIps() { return this._noAutoAssignIps; } |
||||||
|
set noAutoAssignIps(b) { this._noAutoAssignIps = !!b; } |
||||||
|
|
||||||
|
get tags() { return this._tags; } |
||||||
|
set tags(t) |
||||||
|
{ |
||||||
|
} |
||||||
|
|
||||||
|
clear() |
||||||
|
{ |
||||||
|
this._id = ''; |
||||||
|
this._nwid = ''; |
||||||
|
this._authorized = false; |
||||||
|
this._activeBridge = false; |
||||||
|
this._capabilities = []; |
||||||
|
this._identity = ''; |
||||||
|
this._ipAssignments = []; |
||||||
|
this._noAutoAssignIps = false; |
||||||
|
this._tags = []; |
||||||
|
|
||||||
|
this.__creationTime = 0; |
||||||
|
this.__lastAuthorizedTime = 0; |
||||||
|
this.__lastAuthorizedCredentialType = null; |
||||||
|
this.__lastAuthorizedCredential = null; |
||||||
|
this.__lastDeauthorizedTime = 0; |
||||||
|
this.__physicalAddr = ''; |
||||||
|
this.__revision = 0; |
||||||
|
this.__vMajor = 0; |
||||||
|
this.__vMinor = 0; |
||||||
|
this.__vRev = 0; |
||||||
|
this.__vProto = 0; |
||||||
|
} |
||||||
|
}; |
||||||
|
exports.Member = Member; |
||||||
Loading…
Reference in new issue