From eff914dcf21b32201b39eabc85c9f12b6ff863f2 Mon Sep 17 00:00:00 2001 From: Dietmar Maurer Date: Tue, 28 Feb 2017 08:09:08 +0100 Subject: [PATCH] update api data --- api-viewer/apidata.js | 2543 +++++++++++++++++++++++++++++++++---- pmg.conf.5-opts.adoc | 30 +- pmgconfig.1-synopsis.adoc | 6 + pmgperf.1-synopsis.adoc | 2 +- 4 files changed, 2318 insertions(+), 263 deletions(-) diff --git a/api-viewer/apidata.js b/api-viewer/apidata.js index d92378b..82607f3 100644 --- a/api-viewer/apidata.js +++ b/api-viewer/apidata.js @@ -16,9 +16,19 @@ var pmgapi = [ "proxyto" : "master", "returns" : { "items" : { - "properties" : {}, + "properties" : { + "id" : { + "type" : "integer" + } + }, "type" : "object" }, + "links" : [ + { + "href" : "{id}", + "rel" : "child" + } + ], "type" : "array" } } @@ -30,141 +40,2142 @@ var pmgapi = [ { "info" : { "GET" : { - "description" : "Get list of 'action' objects.", + "description" : "Get list of 'action' groups.", + "method" : "GET", + "name" : "list_action_groups", + "parameters" : { + "additionalProperties" : 0 + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "type" : "array" + } + }, + "POST" : { + "description" : "Create a new 'action' group.", + "method" : "POST", + "name" : "create_action_group", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "info" : { + "description" : "Informational comment.", + "maxLength" : 255, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "name" : { + "description" : "Group name.", + "maxLength" : 255, + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "integer" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/action", + "text" : "action" + }, + { + "info" : { + "GET" : { + "description" : "Get list of 'what' groups.", + "method" : "GET", + "name" : "list_what_groups", + "parameters" : { + "additionalProperties" : 0 + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "type" : "array" + } + }, + "POST" : { + "description" : "Create a new 'what' group.", + "method" : "POST", + "name" : "create_what_group", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "info" : { + "description" : "Informational comment.", + "maxLength" : 255, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "name" : { + "description" : "Group name.", + "maxLength" : 255, + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "integer" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/what", + "text" : "what" + }, + { + "info" : { + "GET" : { + "description" : "Get list of 'when' groups.", "method" : "GET", - "name" : "list_actions", + "name" : "list_when_groups", "parameters" : { "additionalProperties" : 0 }, - "protected" : 1, - "proxyto" : "master", - "returns" : { - "items" : { - "properties" : {}, - "type" : "object" - }, - "type" : "array" + "protected" : 1, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "type" : "array" + } + }, + "POST" : { + "description" : "Create a new 'when' group.", + "method" : "POST", + "name" : "create_when_group", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "info" : { + "description" : "Informational comment.", + "maxLength" : 255, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "name" : { + "description" : "Group name.", + "maxLength" : 255, + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "integer" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/when", + "text" : "when" + }, + { + "children" : [ + { + "children" : [ + { + "children" : [ + { + "info" : { + "DELETE" : { + "description" : "Remove an object from the group.", + "method" : "DELETE", + "name" : "delete_object", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Group ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/objects/{id}", + "text" : "{id}" + } + ], + "info" : { + "GET" : { + "description" : "List group objects.", + "method" : "GET", + "name" : "objects", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ogroup" : { + "description" : "Object Group ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{id}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/objects", + "text" : "objects" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Mail address' object settings.", + "method" : "GET", + "name" : "read_email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Mail address' object.", + "method" : "PUT", + "name" : "update_email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/email/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Mail address' object.", + "method" : "POST", + "name" : "email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/email", + "text" : "email" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Domain' object settings.", + "method" : "GET", + "name" : "read_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Domain' object.", + "method" : "PUT", + "name" : "update_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/domain/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Domain' object.", + "method" : "POST", + "name" : "domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/domain", + "text" : "domain" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Regular Expression' object settings.", + "method" : "GET", + "name" : "read_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Regular Expression' object.", + "method" : "PUT", + "name" : "update_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + }, + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/regex/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Regular Expression' object.", + "method" : "POST", + "name" : "regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + }, + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/regex", + "text" : "regex" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'IP Address' object settings.", + "method" : "GET", + "name" : "read_ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'IP Address' object.", + "method" : "PUT", + "name" : "update_ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ip" : { + "description" : "IP address", + "format" : "ip", + "type" : "string", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/ip/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'IP Address' object.", + "method" : "POST", + "name" : "ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ip" : { + "description" : "IP address", + "format" : "ip", + "type" : "string", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/ip", + "text" : "ip" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'IP Network' object settings.", + "method" : "GET", + "name" : "read_network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'IP Network' object.", + "method" : "PUT", + "name" : "update_network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "Network address in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ruledb/who/{ogroup}/network/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'IP Network' object.", + "method" : "POST", + "name" : "network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "Network address in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + }, + "ogroup" : { + "description" : "Object Groups ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}/network", + "text" : "network" + } + ], + "info" : { + "DELETE" : { + "description" : "Delete a 'who' group.", + "method" : "DELETE", + "name" : "delete_who_group", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ogroup" : { + "description" : "Object Group ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + }, + "GET" : { + "description" : "Directory index.", + "method" : "GET", + "name" : "index", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ogroup" : { + "description" : "Object Group ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "returns" : { + "items" : { + "properties" : { + "subdir" : { + "type" : "string" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{subdir}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who/{ogroup}", + "text" : "{ogroup}" + } + ], + "info" : { + "GET" : { + "description" : "Get list of 'who' groups.", + "method" : "GET", + "name" : "list_who_groups", + "parameters" : { + "additionalProperties" : 0 + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "type" : "array" + } + }, + "POST" : { + "description" : "Create a new 'who' group.", + "method" : "POST", + "name" : "create_who_group", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "info" : { + "description" : "Informational comment.", + "maxLength" : 255, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "name" : { + "description" : "Group name.", + "maxLength" : 255, + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb/who", + "text" : "who" + } + ], + "info" : { + "GET" : { + "description" : "Directory index.", + "method" : "GET", + "name" : "index", + "parameters" : { + "additionalProperties" : 0 + }, + "returns" : { + "items" : { + "properties" : {}, + "type" : "object" + }, + "links" : [ + { + "href" : "{name}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/config/ruledb", + "text" : "ruledb" + }, + { + "children" : [ + { + "children" : [ + { + "info" : { + "DELETE" : { + "description" : "Remove an object from the SMTP whitelist.", + "method" : "DELETE", + "name" : "delete_object", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/objects/{id}", + "text" : "{id}" + } + ], + "info" : { + "GET" : { + "description" : "Get list of all SMTP whitelist entries.", + "method" : "GET", + "name" : "objects", + "parameters" : { + "additionalProperties" : 0 + }, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{id}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/objects", + "text" : "objects" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Mail address' object settings.", + "method" : "GET", + "name" : "read_email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Mail address' object.", + "method" : "PUT", + "name" : "update_email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/email/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Mail address' object.", + "method" : "POST", + "name" : "email", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/email", + "text" : "email" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Mail address' object settings.", + "method" : "GET", + "name" : "read_receiver", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Mail address' object.", + "method" : "PUT", + "name" : "update_receiver", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/receiver/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Mail address' object.", + "method" : "POST", + "name" : "receiver", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "email" : { + "description" : "Email address.", + "format" : "email", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/receiver", + "text" : "receiver" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Domain' object settings.", + "method" : "GET", + "name" : "read_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Domain' object.", + "method" : "PUT", + "name" : "update_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/domain/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Domain' object.", + "method" : "POST", + "name" : "domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/domain", + "text" : "domain" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Domain' object settings.", + "method" : "GET", + "name" : "read_receiver_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Domain' object.", + "method" : "PUT", + "name" : "update_receiver_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/receiver_domain/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Domain' object.", + "method" : "POST", + "name" : "receiver_domain", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "DNS domain name (Sender).", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/receiver_domain", + "text" : "receiver_domain" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Regular Expression' object settings.", + "method" : "GET", + "name" : "read_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Regular Expression' object.", + "method" : "PUT", + "name" : "update_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/regex/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Regular Expression' object.", + "method" : "POST", + "name" : "regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/regex", + "text" : "regex" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'Regular Expression' object settings.", + "method" : "GET", + "name" : "read_receiver_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'Regular Expression' object.", + "method" : "PUT", + "name" : "update_receiver_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/receiver_regex/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'Regular Expression' object.", + "method" : "POST", + "name" : "receiver_regex", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "regex" : { + "description" : "Email address regular expression.", + "maxLength" : 1024, + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/receiver_regex", + "text" : "receiver_regex" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'IP Address' object settings.", + "method" : "GET", + "name" : "read_ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'IP Address' object.", + "method" : "PUT", + "name" : "update_ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + }, + "ip" : { + "description" : "IP address", + "format" : "ip", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/ip/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'IP Address' object.", + "method" : "POST", + "name" : "ip", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "ip" : { + "description" : "IP address", + "format" : "ip", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/ip", + "text" : "ip" + }, + { + "children" : [ + { + "info" : { + "GET" : { + "description" : "Read 'IP Network' object settings.", + "method" : "GET", + "name" : "read_network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "id" : { + "type" : "integer" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update 'IP Network' object.", + "method" : "PUT", + "name" : "update_network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "Network address in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + }, + "id" : { + "description" : "Object ID.", + "type" : "integer", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/whitelist/network/{id}", + "text" : "{id}" + } + ], + "info" : { + "POST" : { + "description" : "Add 'IP Network' object.", + "method" : "POST", + "name" : "network", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "Network address in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "description" : "The object ID.", + "type" : "integer" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist/network", + "text" : "network" + } + ], + "info" : { + "GET" : { + "description" : "Directory index.", + "method" : "GET", + "name" : "index", + "parameters" : { + "additionalProperties" : 0 + }, + "returns" : { + "items" : { + "properties" : { + "subdir" : { + "type" : "string" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{subdir}", + "rel" : "child" + } + ], + "type" : "array" + } + } + }, + "leaf" : 0, + "path" : "/config/whitelist", + "text" : "whitelist" + }, + { + "children" : [ + { + "info" : { + "DELETE" : { + "description" : "Delete an LDAP server entry.", + "method" : "DELETE", + "name" : "delete", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "section" : { + "description" : "Secion ID.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + }, + "GET" : { + "description" : "Get LDAP server configuration.", + "method" : "GET", + "name" : "read", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "section" : { + "description" : "Secion ID.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : {} + }, + "PUT" : { + "description" : "Update LDAP server settings.", + "method" : "PUT", + "name" : "update", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "accountattr" : { + "default" : "sAMAccountName", + "description" : "Account attribute name name.", + "optional" : 1, + "pattern" : "[a-zA-Z0-9]+", + "type" : "string" + }, + "basedn" : { + "description" : "Base domain name.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "binddn" : { + "description" : "Bind domain name.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "bindpw" : { + "description" : "Bind password.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "delete" : { + "description" : "A list of settings you want to delete.", + "format" : "pve-configid-list", + "maxLength" : 4096, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "digest" : { + "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.", + "maxLength" : 40, + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "filter" : { + "description" : "LDAP filter.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "groupbasedn" : { + "description" : "Base domain name for groups.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "mailattr" : { + "default" : "mail, userPrincipalName, proxyAddresses, othermailbox", + "description" : "List of mail attribute names.", + "format" : "string-list", + "optional" : 1, + "pattern" : "[a-zA-Z0-9]+", + "type" : "string" + }, + "mode" : { + "default" : "ldap", + "description" : "LDAP protocol mode ('ldap' or 'ldaps').", + "enum" : [ + "ldap", + "ldaps" + ], + "optional" : 1, + "type" : "string" + }, + "port" : { + "description" : "Specify the port to connect to.", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, + "section" : { + "description" : "Secion ID.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + }, + "server1" : { + "description" : "Server address.", + "format" : "address", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "server2" : { + "description" : "Fallback server address. Userd when the first server is not available.", + "format" : "address", + "optional" : 1, + "type" : "string", + "typetext" : "" + } + }, + "type" : "object" + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 1, + "path" : "/config/ldap/{section}", + "text" : "{section}" + } + ], + "info" : { + "GET" : { + "description" : "LDAP server list.", + "method" : "GET", + "name" : "index", + "parameters" : { + "additionalProperties" : 0 + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "items" : { + "properties" : { + "mode" : { + "type" : "string" + }, + "section" : { + "type" : "string" + }, + "server1" : { + "type" : "string" + } + }, + "type" : "object" + }, + "links" : [ + { + "href" : "{section}", + "rel" : "child" + } + ], + "type" : "array" + } + }, + "POST" : { + "description" : "Add LDAP server.", + "method" : "POST", + "name" : "create", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "accountattr" : { + "default" : "sAMAccountName", + "description" : "Account attribute name name.", + "optional" : 1, + "pattern" : "[a-zA-Z0-9]+", + "type" : "string" + }, + "basedn" : { + "description" : "Base domain name.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "binddn" : { + "description" : "Bind domain name.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "bindpw" : { + "description" : "Bind password.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "filter" : { + "description" : "LDAP filter.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "groupbasedn" : { + "description" : "Base domain name for groups.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "mailattr" : { + "default" : "mail, userPrincipalName, proxyAddresses, othermailbox", + "description" : "List of mail attribute names.", + "format" : "string-list", + "optional" : 1, + "pattern" : "[a-zA-Z0-9]+", + "type" : "string" + }, + "mode" : { + "default" : "ldap", + "description" : "LDAP protocol mode ('ldap' or 'ldaps').", + "enum" : [ + "ldap", + "ldaps" + ], + "optional" : 1, + "type" : "string" + }, + "port" : { + "description" : "Specify the port to connect to.", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, + "section" : { + "description" : "Secion ID.", + "format" : "pve-configid", + "type" : "string", + "typetext" : "" + }, + "server1" : { + "description" : "Server address.", + "format" : "address", + "optional" : 0, + "type" : "string", + "typetext" : "" + }, + "server2" : { + "description" : "Fallback server address. Userd when the first server is not available.", + "format" : "address", + "optional" : 1, + "type" : "string", + "typetext" : "" } - } + }, + "type" : "object" }, - "leaf" : 1, - "path" : "/config/ruledb/actions", - "text" : "actions" - }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + } + }, + "leaf" : 0, + "path" : "/config/ldap", + "text" : "ldap" + }, + { + "children" : [ { "info" : { - "GET" : { - "description" : "Get list of 'what' objects.", - "method" : "GET", - "name" : "list_what_object", + "DELETE" : { + "description" : "Delete a relay domain", + "method" : "DELETE", + "name" : "delete", "parameters" : { - "additionalProperties" : 0 + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "Domain name.", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } }, "protected" : 1, "proxyto" : "master", "returns" : { - "items" : { - "properties" : {}, - "type" : "object" - }, - "type" : "array" + "type" : "null" } - } - }, - "leaf" : 1, - "path" : "/config/ruledb/what", - "text" : "what" - }, - { - "info" : { + }, "GET" : { - "description" : "Get list of 'when' objects.", + "description" : "Read Domain data (comment).", "method" : "GET", - "name" : "list_when_object", + "name" : "read", "parameters" : { - "additionalProperties" : 0 + "additionalProperties" : 0, + "properties" : { + "domain" : { + "description" : "Domain name.", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } }, - "protected" : 1, "proxyto" : "master", "returns" : { - "items" : { - "properties" : {}, - "type" : "object" + "properties" : { + "comment" : { + "type" : "string" + }, + "domain" : { + "type" : "string" + } }, - "type" : "array" + "type" : "object" } - } - }, - "leaf" : 1, - "path" : "/config/ruledb/when", - "text" : "when" - }, - { - "info" : { - "GET" : { - "description" : "Get list of 'who' objects.", - "method" : "GET", - "name" : "list_who_object", + }, + "PUT" : { + "description" : "Update relay domain data (comment).", + "method" : "PUT", + "name" : "write", "parameters" : { - "additionalProperties" : 0 + "additionalProperties" : 0, + "properties" : { + "comment" : { + "description" : "Comment.", + "type" : "string", + "typetext" : "" + }, + "domain" : { + "description" : "Domain name.", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } }, "protected" : 1, "proxyto" : "master", "returns" : { - "items" : { - "properties" : {}, - "type" : "object" - }, - "type" : "array" + "type" : "null" } } }, "leaf" : 1, - "path" : "/config/ruledb/who", - "text" : "who" + "path" : "/config/domains/{domain}", + "text" : "{domain}" } ], "info" : { "GET" : { - "description" : "Directory index.", + "description" : "List relay domains.", "method" : "GET", "name" : "index", "parameters" : { "additionalProperties" : 0 }, + "proxyto" : "master", "returns" : { "items" : { - "properties" : {}, + "properties" : { + "comment" : { + "type" : "string" + }, + "domain" : { + "type" : "string" + } + }, "type" : "object" }, "links" : [ { - "href" : "{name}", + "href" : "{domain}", "rel" : "child" } ], "type" : "array" } + }, + "POST" : { + "description" : "Add relay domain.", + "method" : "POST", + "name" : "create", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "comment" : { + "description" : "Comment.", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, + "domain" : { + "description" : "Domain name.", + "format" : "dns-name", + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } } }, "leaf" : 0, - "path" : "/config/ruledb", - "text" : "ruledb" + "path" : "/config/domains", + "text" : "domains" }, { "children" : [ { "info" : { "DELETE" : { - "description" : "Delete an LDAP server entry.", + "description" : "Delete a transport map entry", "method" : "DELETE", "name" : "delete", "parameters" : { "additionalProperties" : 0, "properties" : { - "section" : { - "description" : "Secion ID.", - "format" : "pve-configid", + "domain" : { + "description" : "Domain name.", + "format" : "transport-domain", "type" : "string", "typetext" : "" } @@ -177,131 +2188,83 @@ var pmgapi = [ } }, "GET" : { - "description" : "Get LDAP server configuration.", + "description" : "Read transport map entry.", "method" : "GET", "name" : "read", "parameters" : { "additionalProperties" : 0, "properties" : { - "section" : { - "description" : "Secion ID.", - "format" : "pve-configid", + "domain" : { + "description" : "Domain name.", + "format" : "transport-domain", "type" : "string", "typetext" : "" } } }, - "protected" : 1, "proxyto" : "master", - "returns" : {} - }, - "PUT" : { - "description" : "Update LDAP server settings.", - "method" : "PUT", - "name" : "update", - "parameters" : { - "additionalProperties" : 0, + "returns" : { "properties" : { - "accountattr" : { - "default" : "sAMAccountName", - "description" : "Account attribute name name.", - "optional" : 1, - "pattern" : "[a-zA-Z0-9]+", + "comment" : { "type" : "string" }, - "basedn" : { - "description" : "Base domain name.", - "optional" : 1, - "type" : "string", - "typetext" : "" - }, - "binddn" : { - "description" : "Bind domain name.", - "optional" : 1, - "type" : "string", - "typetext" : "" - }, - "bindpw" : { - "description" : "Bind password.", - "optional" : 1, - "type" : "string", - "typetext" : "" + "domain" : { + "type" : "string" }, - "delete" : { - "description" : "A list of settings you want to delete.", - "format" : "pve-configid-list", - "maxLength" : 4096, - "optional" : 1, - "type" : "string", - "typetext" : "" + "host" : { + "type" : "string" }, - "digest" : { - "description" : "Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.", - "maxLength" : 40, + "port" : { + "type" : "integer" + }, + "use_mx" : { + "type" : "boolean" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update transport map entry.", + "method" : "PUT", + "name" : "write", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "comment" : { + "description" : "Comment.", "optional" : 1, "type" : "string", "typetext" : "" }, - "filter" : { - "description" : "LDAP filter.", - "optional" : 1, + "domain" : { + "description" : "Domain name.", + "format" : "transport-domain", "type" : "string", "typetext" : "" }, - "groupbasedn" : { - "description" : "Base domain name for groups.", + "host" : { + "description" : "Target host (name or IP address).", + "format" : "address", "optional" : 1, "type" : "string", "typetext" : "" }, - "mailattr" : { - "default" : "mail, userPrincipalName, proxyAddresses, othermailbox", - "description" : "List of mail attribute names.", - "format" : "string-list", - "optional" : 1, - "pattern" : "[a-zA-Z0-9]+", - "type" : "string" - }, - "mode" : { - "default" : "ldap", - "description" : "LDAP protocol mode ('ldap' or 'ldaps').", - "enum" : [ - "ldap", - "ldaps" - ], - "optional" : 1, - "type" : "string" - }, "port" : { - "description" : "Specify the port to connect to.", + "description" : "SMTP port.", "maximum" : 65535, "minimum" : 1, "optional" : 1, "type" : "integer", "typetext" : " (1 - 65535)" }, - "section" : { - "description" : "Secion ID.", - "format" : "pve-configid", - "type" : "string", - "typetext" : "" - }, - "server1" : { - "description" : "Server address.", - "format" : "address", - "optional" : 1, - "type" : "string", - "typetext" : "" - }, - "server2" : { - "description" : "Fallback server address. Userd when the first server is not available.", - "format" : "address", + "use_mx" : { + "description" : "Enable MX lookups.", "optional" : 1, - "type" : "string", - "typetext" : "" + "type" : "boolean", + "typetext" : "" } - }, - "type" : "object" + } }, "protected" : 1, "proxyto" : "master", @@ -311,38 +2274,43 @@ var pmgapi = [ } }, "leaf" : 1, - "path" : "/config/ldap/{section}", - "text" : "{section}" + "path" : "/config/transport/{domain}", + "text" : "{domain}" } ], "info" : { "GET" : { - "description" : "LDAP server list.", + "description" : "List transport map entries.", "method" : "GET", "name" : "index", "parameters" : { "additionalProperties" : 0 }, - "protected" : 1, "proxyto" : "master", "returns" : { "items" : { "properties" : { - "mode" : { + "comment" : { "type" : "string" }, - "section" : { + "domain" : { "type" : "string" }, - "server1" : { + "host" : { "type" : "string" + }, + "port" : { + "type" : "integer" + }, + "use_mx" : { + "type" : "boolean" } }, "type" : "object" }, "links" : [ { - "href" : "{section}", + "href" : "{id}", "rel" : "child" } ], @@ -350,97 +2318,47 @@ var pmgapi = [ } }, "POST" : { - "description" : "Add LDAP server.", + "description" : "Add transport map entry.", "method" : "POST", "name" : "create", "parameters" : { "additionalProperties" : 0, "properties" : { - "accountattr" : { - "default" : "sAMAccountName", - "description" : "Account attribute name name.", - "optional" : 1, - "pattern" : "[a-zA-Z0-9]+", - "type" : "string" - }, - "basedn" : { - "description" : "Base domain name.", - "optional" : 1, - "type" : "string", - "typetext" : "" - }, - "binddn" : { - "description" : "Bind domain name.", + "comment" : { + "description" : "Comment.", "optional" : 1, "type" : "string", "typetext" : "" }, - "bindpw" : { - "description" : "Bind password.", - "optional" : 1, - "type" : "string", - "typetext" : "" - }, - "filter" : { - "description" : "LDAP filter.", - "optional" : 1, + "domain" : { + "description" : "Domain name.", + "format" : "transport-domain", "type" : "string", "typetext" : "" }, - "groupbasedn" : { - "description" : "Base domain name for groups.", - "optional" : 1, + "host" : { + "description" : "Target host (name or IP address).", + "format" : "address", "type" : "string", "typetext" : "" }, - "mailattr" : { - "default" : "mail, userPrincipalName, proxyAddresses, othermailbox", - "description" : "List of mail attribute names.", - "format" : "string-list", - "optional" : 1, - "pattern" : "[a-zA-Z0-9]+", - "type" : "string" - }, - "mode" : { - "default" : "ldap", - "description" : "LDAP protocol mode ('ldap' or 'ldaps').", - "enum" : [ - "ldap", - "ldaps" - ], - "optional" : 1, - "type" : "string" - }, "port" : { - "description" : "Specify the port to connect to.", + "default" : 25, + "description" : "SMTP port.", "maximum" : 65535, "minimum" : 1, "optional" : 1, "type" : "integer", "typetext" : " (1 - 65535)" }, - "section" : { - "description" : "Secion ID.", - "format" : "pve-configid", - "type" : "string", - "typetext" : "" - }, - "server1" : { - "description" : "Server address.", - "format" : "address", - "optional" : 0, - "type" : "string", - "typetext" : "" - }, - "server2" : { - "description" : "Fallback server address. Userd when the first server is not available.", - "format" : "address", + "use_mx" : { + "default" : 1, + "description" : "Enable MX lookups.", "optional" : 1, - "type" : "string", - "typetext" : "" + "type" : "boolean", + "typetext" : "" } - }, - "type" : "object" + } }, "protected" : 1, "proxyto" : "master", @@ -450,23 +2368,76 @@ var pmgapi = [ } }, "leaf" : 0, - "path" : "/config/ldap", - "text" : "ldap" + "path" : "/config/transport", + "text" : "transport" }, { "children" : [ { "info" : { "DELETE" : { - "description" : "Delete a relay domain", + "description" : "Delete a truster network", "method" : "DELETE", "name" : "delete", "parameters" : { "additionalProperties" : 0, "properties" : { - "domain" : { - "description" : "Domain name.", - "format" : "dns-name", + "cidr" : { + "description" : "IPv4 or IPv6 network in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + } + } + }, + "protected" : 1, + "proxyto" : "master", + "returns" : { + "type" : "null" + } + }, + "GET" : { + "description" : "Read trusted network data (comment).", + "method" : "GET", + "name" : "read", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "IPv4 or IPv6 network in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + } + } + }, + "proxyto" : "master", + "returns" : { + "properties" : { + "cidr" : { + "type" : "string" + }, + "comment" : { + "type" : "string" + } + }, + "type" : "object" + } + }, + "PUT" : { + "description" : "Update trusted data (comment).", + "method" : "PUT", + "name" : "write", + "parameters" : { + "additionalProperties" : 0, + "properties" : { + "cidr" : { + "description" : "IPv4 or IPv6 network in CIDR notation.", + "type" : "string", + "typetext" : "" + }, + "comment" : { + "description" : "Comment.", "type" : "string", "typetext" : "" } @@ -480,13 +2451,13 @@ var pmgapi = [ } }, "leaf" : 1, - "path" : "/config/domains/{domain}", - "text" : "{domain}" + "path" : "/config/mynetworks/{cidr}", + "text" : "{cidr}" } ], "info" : { "GET" : { - "description" : "List relay domains.", + "description" : "List of trusted networks from where SMTP clients are allowed to relay mail through Proxmox Mail Gateway.", "method" : "GET", "name" : "index", "parameters" : { @@ -496,7 +2467,7 @@ var pmgapi = [ "returns" : { "items" : { "properties" : { - "domain" : { + "cidr" : { "type" : "string" } }, @@ -504,7 +2475,7 @@ var pmgapi = [ }, "links" : [ { - "href" : "{section}", + "href" : "{cide}", "rel" : "child" } ], @@ -512,15 +2483,21 @@ var pmgapi = [ } }, "POST" : { - "description" : "Add relay domain.", + "description" : "Add a trusted network.", "method" : "POST", "name" : "create", "parameters" : { "additionalProperties" : 0, "properties" : { - "domain" : { - "description" : "Domain name.", - "format" : "dns-name", + "cidr" : { + "description" : "IPv4 or IPv6 network in CIDR notation.", + "format" : "CIDR", + "type" : "string", + "typetext" : "" + }, + "comment" : { + "description" : "Comment.", + "optional" : 1, "type" : "string", "typetext" : "" } @@ -534,8 +2511,8 @@ var pmgapi = [ } }, "leaf" : 0, - "path" : "/config/domains", - "text" : "domains" + "path" : "/config/mynetworks", + "text" : "mynetworks" }, { "info" : { @@ -619,6 +2596,14 @@ var pmgapi = [ "type" : "string", "typetext" : "" }, + "email" : { + "default" : "admin@domain.tld", + "description" : "Administrator E-Mail address.", + "format" : "email", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "proxypassword" : { "description" : "HTTP proxy password.", "optional" : 1, @@ -837,6 +2822,15 @@ var pmgapi = [ "type" : "integer", "typetext" : " (0 - N)" }, + "ext_port" : { + "default" : 26, + "description" : "SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'.", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, "greylist" : { "default" : 1, "description" : "Use Greylisting.", @@ -858,6 +2852,15 @@ var pmgapi = [ "type" : "boolean", "typetext" : "" }, + "int_port" : { + "default" : 25, + "description" : "SMTP port number for outgoing mail (trusted).", + "maximum" : 65535, + "minimum" : 1, + "optional" : 1, + "type" : "integer", + "typetext" : " (1 - 65535)" + }, "max_filters" : { "default" : 15, "description" : "Maximum number of pmg-smtp-filter processes.", @@ -926,6 +2929,7 @@ var pmgapi = [ }, "relay" : { "description" : "The default mail delivery transport (incoming mails).", + "format" : "address", "optional" : 1, "type" : "string", "typetext" : "" @@ -946,6 +2950,13 @@ var pmgapi = [ "type" : "integer", "typetext" : " (1 - 65535)" }, + "smarthost" : { + "description" : "When set, all outgoing mails are deliverd to the specified smarthost.", + "format" : "address", + "optional" : 1, + "type" : "string", + "typetext" : "" + }, "spf" : { "default" : 1, "description" : "Use Sender Policy Framework.", @@ -955,7 +2966,21 @@ var pmgapi = [ }, "tls" : { "default" : 0, - "description" : "Use TLS.", + "description" : "Enable TLS.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, + "tlsheader" : { + "default" : 0, + "description" : "Add TLS received header.", + "optional" : 1, + "type" : "boolean", + "typetext" : "" + }, + "tlslog" : { + "default" : 0, + "description" : "Enable TLS Logging.", "optional" : 1, "type" : "boolean", "typetext" : "" @@ -968,13 +2993,13 @@ var pmgapi = [ "typetext" : "" }, "verifyreceivers" : { - "default" : 0, - "description" : "Enable receiver verification. The value (if greater than 0) spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address (450 or 550).", - "maximum" : 599, - "minimum" : 0, + "description" : "Enable receiver verification. The value spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address.", + "enum" : [ + "450", + "550" + ], "optional" : 1, - "type" : "integer", - "typetext" : " (0 - 599)" + "type" : "string" } }, "type" : "object" diff --git a/pmg.conf.5-opts.adoc b/pmg.conf.5-opts.adoc index ee6ecce..3f65598 100644 --- a/pmg.conf.5-opts.adoc +++ b/pmg.conf.5-opts.adoc @@ -16,6 +16,10 @@ Demo mode - do not start SMTP filter. Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. +`email`: `` ('default =' `admin@domain.tld`):: + +Administrator E-Mail address. + `proxypassword`: `` :: HTTP proxy password. @@ -100,6 +104,10 @@ Optional list of DNS white/blacklist domains (see postscreen_dnsbl_sites paramet SMTP delay warning time (in hours). +`ext_port`: ` (1 - 65535)` ('default =' `26`):: + +SMTP port number for incoming mail (untrusted). This must be a different number than 'int_port'. + `greylist`: `` ('default =' `1`):: Use Greylisting. @@ -112,6 +120,10 @@ Use SMTP HELO tests. Hide received header in outgoing mails. +`int_port`: ` (1 - 65535)` ('default =' `25`):: + +SMTP port number for outgoing mail (trusted). + `max_filters`: ` (3 - 40)` ('default =' `15`):: Maximum number of pmg-smtp-filter processes. @@ -156,21 +168,33 @@ Disable MX lookups for default relay. SMTP port number for relay host. +`smarthost`: `` :: + +When set, all outgoing mails are deliverd to the specified smarthost. + `spf`: `` ('default =' `1`):: Use Sender Policy Framework. `tls`: `` ('default =' `0`):: -Use TLS. +Enable TLS. + +`tlsheader`: `` ('default =' `0`):: + +Add TLS received header. + +`tlslog`: `` ('default =' `0`):: + +Enable TLS Logging. `use_rbl`: `` ('default =' `1`):: Use Realtime Blacklists. -`verifyreceivers`: ` (0 - 599)` ('default =' `0`):: +`verifyreceivers`: `<450 | 550>` :: -Enable receiver verification. The value (if greater than 0) spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address (450 or 550). +Enable receiver verification. The value spefifies the numerical reply code when the Postfix SMTP server rejects a recipient address. .Section 'spam' diff --git a/pmgconfig.1-synopsis.adoc b/pmgconfig.1-synopsis.adoc index eb69b84..06839db 100644 --- a/pmgconfig.1-synopsis.adoc +++ b/pmgconfig.1-synopsis.adoc @@ -33,6 +33,12 @@ Verbose output format. +*pmgconfig init* + +Generate required files in /etc/pmg/ + + + *pmgconfig ldapsync* Syncronize the LDAP database. diff --git a/pmgperf.1-synopsis.adoc b/pmgperf.1-synopsis.adoc index 3ab6d76..43bcc2f 100644 --- a/pmgperf.1-synopsis.adoc +++ b/pmgperf.1-synopsis.adoc @@ -6,5 +6,5 @@ Proxmox benchmark. ``: `` ('default =' `/`):: -no description available +File system localtion to test. -- 2.39.2