0.1.1 • Published 10 years ago

stormlight v0.1.1

Weekly downloads
8
License
MIT
Repository
github
Last release
10 years ago

Stormlight

Stormlight is basically one of the stormstack modules which inherits JSON objects from all the other stormflash modules such as corenova-strom, openvpn-storm, commtouch-storm by importing these modules. When a mobile device changes the policy, stormlight needs to identify new changes and find out the respective stormflash modules which get affected and then build the JSON format which is expected by each of these modules to update configuration in VSC.

List of stromlight APIs

POST Domains API

Verb      URI                       Description
POST      /domains                  Creates the Domains  configuration.

On success it returns JSON data with the UUID with the domains created configuration.

Example Request and Response

Request JSON

{
    "name": "string",
    "description": "string",
    "metapolicy": {
        "name": "string",
        "description": "string",
        "enabled": true,
        "groups": [
            {
                "id": "uuid",
                "name": "string",
                "description": "string",
                "identities": [
                    {
                        "type": "user.cname",
                        "value": "a2cdff9d-293d-413d-b07a-dc497b123527"
                    }
                ],
                "networks": [
                    {
                        "id": "uuid",
                        "cidr": "192.168.100.0/24",
                        "family": "IPv4"
                    }
                ],
                "rules": [
                    {
                        "policy": "policy uuid",
                        "during": "business hours"
                    }
                ]
            }
        ],
        "activeVersion": "string",
        "versions": [
            {
                "id": "uuid",
                "version": "string",
                "config": {
                    "SSL_INSPECT_CABUNDLE": {
                        "filename": "ca-cert.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "SSL_INSPECT_CACERT": {
                        "filename": "rootcert.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "SSL_INSPECT_CAKEY": {
                        "filename": "rootkey.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CABUNDLE": {
                        "filename": "ca-bundle.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CACERT": {
                        "filename": "openvpn.cert",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CAKEY": {
                        "filename": "openvpn.key",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    }
                },
                "lastModified": "timestamp"
            }
        ],
        "default": false,
        "createdAt": "string",
        "lastModified": "string"
    },
    "policies": [
        {
            "name": "string",
            "description": "string",
            "enabled": true,
            "activeVersion": "string",
            "versions": [
                {
                    "id": "uuid",
                    "version": "string",
                    "config": {
                        "web": {
                            "contentFilter": {
                                "enable": true,
                                "commtouch": {
                                    "blockedList": [
                                        2,
                                        3,
                                        4
                                    ],
                                    "enable": false,
                                    "name": "default"
                                },
                                "safesearch": {
                                    "enable": false
                                },
                                "customFilter": {
                                    "blacklist": [
                                        "www.site.com"
                                    ],
                                    "custom": false,
                                    "name": "Default Policy Exception",
                                    "whitelist": [
                                        "www.site.com"
                                    ]
                                },
                                "kaspersky": {
                                    "download": true,
                                    "enable": true,
                                    "upload": true
                                }
                            }
                        },
                        "mail": {
                            "kaspersky": {
                                "enable": true,
                                "imap": true,
                                "pop3": true,
                                "smtp": true
                            }
                        },
                        "ssl": {
                            "inspection": {
                                "enable": false,
                                "inspectSubDomain": true,
                                "showWarning": true,
                                "exceptions": [
                                    {
                                        "custom": false,
                                        "name": "ssl inspection exceptions",
                                        "whitelist": [
                                            "www.site.com"
                                        ]
                                    }
                                ]
                            },
                            "connectionFilter": {
                                "enable": false,
                                "includeSubDomain": false,
                                "restrictSelfSignedCert": false,
                                "restrictSslCert": false,
                                "exceptions": [
                                    {
                                        "blacklist": [
                                            "www.site.com"
                                        ],
                                        "custom": false,
                                        "name": "ssl connection exceptions"
                                    }
                                ]
                            }
                        }
                    },
                    "lastModified": "timestamp"
                }
            ],
            "default": false,
            "createdAt": "string",
            "lastModified": "string"
        }
    ],
    "agents": [
        "2328f438-b1e2-4e2d-b521-f7151e4285c9"
    ],
    "packages": [],
    "services": [
        "web.kaspersky",
        "web.contentfiltering",
        "mail.kaspersky",
        "ssl.certificateinspection",
        "ssl.contentinspection"
    ],
    "enabled": true
}

Response JSON

{
   "name": "string",
   "description": "string",
   "metapolicy":
   {
       "name": "string",
       "description": "string",
       "enabled": true,
       "groups":
       [
           {
               "id": "a36a59dc-2de5-46a9-9e18-a7fb0c48b368",
               "name": "string",
               "description": "string",
               "identities":
               [
                   {
                       "type": "user.cname",
                       "value": "a2cdff9d-293d-413d-b07a-dc497b123527"
                   }
               ],
               "networks":
               [
                   {
                       "id": "uuid",
                       "cidr": "192.168.100.0/24",
                       "family": "IPv4"
                   }
               ],
               "rules":
               [
                   {
                       "policy": "policy uuid",
                       "during": "business hours"
                   }
               ]
           }
       ],
       "activeVersion": "0.0",
       "versions":
       [
           {
               "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26",
               "version": "0.0",
               "config":
               {
                   "SSL_INSPECT_CABUNDLE":
                   {
                       "filename": "ca-cert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CACERT":
                   {
                       "filename": "rootcert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CAKEY":
                   {
                       "filename": "rootkey.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CABUNDLE":
                   {
                       "filename": "ca-bundle.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CACERT":
                   {
                       "filename": "openvpn.cert",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CAKEY":
                   {
                       "filename": "openvpn.key",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   }
               },
               "lastModified": "05:13:2014 11:09:58"
           }
       ],
       "default": false,
       "createdAt": "string",
       "lastModified": "string",
       "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26"
   },
   "policies":
   [
       {
           "name": "string",
           "description": "string",
           "enabled": true,
           "activeVersion": "0.0",
           "versions":
           [
               {
                   "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
                   "version": "0.0",
                   "config":
                   {
                       "web":
                       {
                           "contentFilter":
                           {
                               "enable": true,
                               "commtouch":
                               {
                                   "blockedList":
                                   [
                                       2,
                                       3,
                                       4
                                   ],
                                   "enable": false,
                                   "name": "default"
                               },
                               "safesearch":
                               {
                                   "enable": false
                               },
                               "customFilter":
                               {
                                   "blacklist":
                                   [
                                       "www.site.com"
                                   ],
                                   "custom": false,
                                   "name": "Default Policy Exception",
                                   "whitelist":
                                   [
                                       "www.site.com"
                                   ]
                               },
                               "kaspersky":
                               {
                                   "download": true,
                                   "enable": true,
                                   "upload": true
                               }
                           }
                       },
                       "mail":
                       {
                           "kaspersky":
                           {
                               "enable": true,
                               "imap": true,
                               "pop3": true,
                               "smtp": true
                           }
                       },
                       "ssl":
                       {
                           "inspection":
                           {
                               "enable": false,
                               "inspectSubDomain": true,
                               "showWarning": true,
                               "exceptions":
                               [
                                   {
                                       "custom": false,
                                       "name": "ssl inspection exceptions",
                                       "whitelist":
                                       [
                                           "www.site.com"
                                       ]
                                   }
                               ]
                           },
                           "connectionFilter":
                           {
                               "enable": false,
                               "includeSubDomain": false,
                               "restrictSelfSignedCert": false,
                               "restrictSslCert": false,
                               "exceptions":
                               [
                                   {
                                       "blacklist":
                                       [
                                           "www.site.com"
                                       ],
                                       "custom": false,
                                       "name": "ssl connection exceptions"
                                   }
                               ]
                           }
                       }
                   },
                   "lastModified": "05:13:2014 11:09:58"
               }
           ],
           "default": false,
           "createdAt": "string",
           "lastModified": "string",
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
       }
   ],
   "agents":
   [
       "2328f438-b1e2-4e2d-b521-f7151e4285c9"
   ],
   "packages":
   [
   ],
   "services":
   [
       "web.kaspersky",
       "web.contentfiltering",
       "mail.kaspersky",
       "ssl.certificateinspection",
       "ssl.contentinspection"
   ],
   "enabled": true,
   "id": "39625f7e-a71e-450e-b8d1-c2ba37ffe0b1"
}

GET List API

Verb       URI	                    Description
GET	       /domains/:id   	        List summary of domains configured.

Example Request and Response

Response JSON

 {
   "name": "string",
   "description": "string",
   "metapolicy":
   {
       "name": "string",
       "description": "string",
       "enabled": true,
       "groups":
       [
           {
               "id": "a36a59dc-2de5-46a9-9e18-a7fb0c48b368",
               "name": "string",
               "description": "string",
               "identities":
               [
                   {
                       "type": "user.cname",
                       "value": "a2cdff9d-293d-413d-b07a-dc497b123527"
                   }
               ],
               "networks":
               [
                   {
                       "id": "uuid",
                       "cidr": "192.168.100.0/24",
                       "family": "IPv4"
                   }
               ],
               "rules":
               [
                   {
                       "policy": "policy uuid",
                       "during": "business hours"
                   }
               ]
           }
       ],
       "activeVersion": "0.0",
       "versions":
       [
           {
               "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26",
               "version": "0.0",
               "config":
               {
                   "SSL_INSPECT_CABUNDLE":
                   {
                       "filename": "ca-cert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CACERT":
                   {
                       "filename": "rootcert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CAKEY":
                   {
                       "filename": "rootkey.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CABUNDLE":
                   {
                       "filename": "ca-bundle.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CACERT":
                   {
                       "filename": "openvpn.cert",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CAKEY":
                   {
                       "filename": "openvpn.key",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   }
               },
               "lastModified": "05:13:2014 11:09:58"
           }
       ],
       "default": false,
       "createdAt": "string",
       "lastModified": "string",
       "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26"
   },
   "policies":
   [
       {
           "name": "string",
           "description": "string",
           "enabled": true,
           "activeVersion": "0.0",
           "versions":
           [
               {
                   "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
                   "version": "0.0",
                   "config":
                   {
                       "web":
                       {
                           "contentFilter":
                           {
                               "enable": true,
                               "commtouch":
                               {
                                   "blockedList":
                                   [
                                       2,
                                       3,
                                       4
                                   ],
                                   "enable": false,
                                   "name": "default"
                               },
                               "safesearch":
                               {
                                   "enable": false
                               },
                               "customFilter":
                               {
                                   "blacklist":
                                   [
                                       "www.site.com"
                                   ],
                                   "custom": false,
                                   "name": "Default Policy Exception",
                                   "whitelist":
                                   [
                                       "www.site.com"
                                   ]
                               },
                               "kaspersky":
                               {
                                   "download": true,
                                   "enable": true,
                                   "upload": true
                               }
                           }
                       },
                       "mail":
                       {
                           "kaspersky":
                           {
                               "enable": true,
                               "imap": true,
                               "pop3": true,
                               "smtp": true
                           }
                       },
                       "ssl":
                       {
                           "inspection":
                           {
                               "enable": false,
                               "inspectSubDomain": true,
                               "showWarning": true,
                               "exceptions":
                               [
                                   {
                                       "custom": false,
                                       "name": "ssl inspection exceptions",
                                       "whitelist":
                                       [
                                           "www.site.com"
                                       ]
                                   }
                               ]
                           },
                           "connectionFilter":
                           {
                               "enable": false,
                               "includeSubDomain": false,
                               "restrictSelfSignedCert": false,
                               "restrictSslCert": false,
                               "exceptions":
                               [
                                   {
                                       "blacklist":
                                       [
                                           "www.site.com"
                                       ],
                                       "custom": false,
                                       "name": "ssl connection exceptions"
                                   }
                               ]
                           }
                       }
                   },
                   "lastModified": "05:13:2014 11:09:58"
               }
           ],
           "default": false,
           "createdAt": "string",
           "lastModified": "string",
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
       }
   ],
   "agents":
   [
       "2328f438-b1e2-4e2d-b521-f7151e4285c9"
   ],
   "packages":
   [
   ],
   "services":
   [
       "web.kaspersky",
       "web.contentfiltering",
       "mail.kaspersky",
       "ssl.certificateinspection",
       "ssl.contentinspection"
   ],
   "enabled": true,
   "id": "39625f7e-a71e-450e-b8d1-c2ba37ffe0b1"
}

PUT API

Verb       URI                          Description
PUT	       /domains/:id    	            Update the domains configuration by domains ID.

On success it returns JSON data with the UUID with the domains updated configuration by domains ID.

Example Request and Response

Request JSON

{
    "name": "string",
    "description": "string",
    "metapolicy": {
        "name": "string",
        "description": "string",
        "enabled": true,
        "groups": [
            {
                "id": "uuid",
                "name": "string",
                "description": "string",
                "identities": [
                    {
                        "type": "user.cname",
                        "value": "a2cdff9d-293d-413d-b07a-dc497b123527"
                    }
                ],
                "networks": [
                    {
                        "id": "uuid",
                        "cidr": "192.168.100.0/24",
                        "family": "IPv4"
                    }
                ],
                "rules": [
                    {
                        "policy": "policy uuid",
                        "during": "business hours"
                    }
                ]
            }
        ],
        "activeVersion": "string",
        "versions": [
            {
                "id": "uuid",
                "version": "string",
                "config": {
                    "SSL_INSPECT_CABUNDLE": {
                        "filename": "ca-cert.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "SSL_INSPECT_CACERT": {
                        "filename": "rootcert.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "SSL_INSPECT_CAKEY": {
                        "filename": "rootkey.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CABUNDLE": {
                        "filename": "ca-bundle.pem",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CACERT": {
                        "filename": "openvpn.cert",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    },
                    "OPENVPN_CAKEY": {
                        "filename": "openvpn.key",
                        "encoding": "base64",
                        "data": "base64 encoded data"
                    }
                },
                "lastModified": "timestamp"
            }
        ],
        "default": false,
        "createdAt": "string",
        "lastModified": "string"
    },
    "policies": [
        {
            "name": "string",
            "description": "string",
            "enabled": true,
            "activeVersion": "string",
            "versions": [
                {
                    "id": "uuid",
                    "version": "string",
                    "config": {
                        "web": {
                            "contentFilter": {
                                "enable": true,
                                "commtouch": {
                                    "blockedList": [
                                        2,
                                        3,
                                        4
                                    ],
                                    "enable": false,
                                    "name": "default"
                                },
                                "safesearch": {
                                    "enable": false
                                },
                                "customFilter": {
                                    "blacklist": [
                                        "www.site.com"
                                    ],
                                    "custom": false,
                                    "name": "Default Policy Exception",
                                    "whitelist": [
                                        "www.site.com"
                                    ]
                                },
                                "kaspersky": {
                                    "download": true,
                                    "enable": true,
                                    "upload": true
                                }
                            }
                        },
                        "mail": {
                            "kaspersky": {
                                "enable": true,
                                "imap": true,
                                "pop3": true,
                                "smtp": true
                            }
                        },
                        "ssl": {
                            "inspection": {
                                "enable": false,
                                "inspectSubDomain": true,
                                "showWarning": true,
                                "exceptions": [
                                    {
                                        "custom": false,
                                        "name": "ssl inspection exceptions",
                                        "whitelist": [
                                            "www.site.com"
                                        ]
                                    }
                                ]
                            },
                            "connectionFilter": {
                                "enable": false,
                                "includeSubDomain": false,
                                "restrictSelfSignedCert": false,
                                "restrictSslCert": false,
                                "exceptions": [
                                    {
                                        "blacklist": [
                                            "www.site.com"
                                        ],
                                        "custom": false,
                                        "name": "ssl connection exceptions"
                                    }
                                ]
                            }
                        }
                    },
                    "lastModified": "timestamp"
                }
            ],
            "default": false,
            "createdAt": "string",
            "lastModified": "string"
        }
    ],
    "agents": [
        "2328f438-b1e2-4e2d-b521-f7151e4285c9"
    ],
    "packages": [],
    "services": [
        "web.kaspersky",
        "web.contentfiltering",
        "mail.kaspersky",
        "ssl.certificateinspection",
        "ssl.contentinspection"
    ],
    "enabled": true
}

Response JSON

{
   "name": "string",
   "description": "string",
   "metapolicy":
   {
       "name": "string",
       "description": "string",
       "enabled": true,
       "groups":
       [
           {
               "id": "a36a59dc-2de5-46a9-9e18-a7fb0c48b368",
               "name": "string",
               "description": "string",
               "identities":
               [
                   {
                       "type": "user.cname",
                       "value": "a2cdff9d-293d-413d-b07a-dc497b123527"
                   }
               ],
               "networks":
               [
                   {
                       "id": "uuid",
                       "cidr": "192.168.100.0/24",
                       "family": "IPv4"
                   }
               ],
               "rules":
               [
                   {
                       "policy": "policy uuid",
                       "during": "business hours"
                   }
               ]
           }
       ],
       "activeVersion": "0.0",
       "versions":
       [
           {
               "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26",
               "version": "0.0",
               "config":
               {
                   "SSL_INSPECT_CABUNDLE":
                   {
                       "filename": "ca-cert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CACERT":
                   {
                       "filename": "rootcert.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "SSL_INSPECT_CAKEY":
                   {
                       "filename": "rootkey.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CABUNDLE":
                   {
                       "filename": "ca-bundle.pem",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CACERT":
                   {
                       "filename": "openvpn.cert",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   },
                   "OPENVPN_CAKEY":
                   {
                       "filename": "openvpn.key",
                       "encoding": "base64",
                       "data": "base64 encoded data"
                   }
               },
               "lastModified": "05:13:2014 11:09:58"
           }
       ],
       "default": false,
       "createdAt": "string",
       "lastModified": "string",
       "id": "6a1f9cd7-ca4a-463e-b22f-787e62652f26"
   },
   "policies":
   [
       {
           "name": "string",
           "description": "string",
           "enabled": true,
           "activeVersion": "0.0",
           "versions":
           [
               {
                   "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
                   "version": "0.0",
                   "config":
                   {
                       "web":
                       {
                           "contentFilter":
                           {
                               "enable": true,
                               "commtouch":
                               {
                                   "blockedList":
                                   [
                                       2,
                                       3,
                                       4
                                   ],
                                   "enable": false,
                                   "name": "default"
                               },
                               "safesearch":
                               {
                                   "enable": false
                               },
                               "customFilter":
                               {
                                   "blacklist":
                                   [
                                       "www.site.com"
                                   ],
                                   "custom": false,
                                   "name": "Default Policy Exception",
                                   "whitelist":
                                   [
                                       "www.site.com"
                                   ]
                               },
                               "kaspersky":
                               {
                                   "download": true,
                                   "enable": true,
                                   "upload": true
                               }
                           }
                       },
                       "mail":
                       {
                           "kaspersky":
                           {
                               "enable": true,
                               "imap": true,
                               "pop3": true,
                               "smtp": true
                           }
                       },
                       "ssl":
                       {
                           "inspection":
                           {
                               "enable": false,
                               "inspectSubDomain": true,
                               "showWarning": true,
                               "exceptions":
                               [
                                   {
                                       "custom": false,
                                       "name": "ssl inspection exceptions",
                                       "whitelist":
                                       [
                                           "www.site.com"
                                       ]
                                   }
                               ]
                           },
                           "connectionFilter":
                           {
                               "enable": false,
                               "includeSubDomain": false,
                               "restrictSelfSignedCert": false,
                               "restrictSslCert": false,
                               "exceptions":
                               [
                                   {
                                       "blacklist":
                                       [
                                           "www.site.com"
                                       ],
                                       "custom": false,
                                       "name": "ssl connection exceptions"
                                   }
                               ]
                           }
                       }
                   },
                   "lastModified": "05:13:2014 11:09:58"
               }
           ],
           "default": false,
           "createdAt": "string",
           "lastModified": "string",
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
       }
   ],
   "agents":
   [
       "2328f438-b1e2-4e2d-b521-f7151e4285c9"
   ],
   "packages":
   [
   ],
   "services":
   [
       "web.kaspersky",
       "web.contentfiltering",
       "mail.kaspersky",
       "ssl.certificateinspection",
       "ssl.contentinspection"
   ],
   "enabled": true,
   "id": "39625f7e-a71e-450e-b8d1-c2ba37ffe0b1"
}

DELETE Domains API

Verb      URI                            Description
DELETE   /domains/:id                    Delete existing domains configuration by ID.

Example Request and Response

Request Headers

DELETE http://stormlight:8282/domains/:id

Response Header

Status Code : 204

POST Policies API

Verb       URI                          Description
POST	     /domains/:id/policies    	  Create policies configuration in domains.

On success it returns JSON data with the UUID for the policies created configuration in domains by ID.

Example Request and Response

Request JSON

{
   "name": "put policies",
   "description": "string",
   "enabled": true,
   "activeVersion": "0.0",
   "versions":
   [
       {
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
           "version": "0.0",
           "config":
           {
               "web":
               {
                   "contentFilter":
                   {
                       "enable": true,
                       "commtouch":
                       {
                           "blockedList":
                           [
                               12,
                               13,
                               14
                           ],
                           "enable": false,
                           "name": "default"
                       },
                       "safesearch":
                       {
                           "enable": false
                       },
                       "customFilter":
                       {
                           "blacklist":
                           [
                               "www.site.com"
                           ],
                           "custom": false,
                           "name": "Default Policy Exception",
                           "whitelist":
                           [
                               "www.site.com"
                           ]
                       },
                       "kaspersky":
                       {
                           "download": true,
                           "enable": true,
                           "upload": true
                       }
                   }
               },
               "mail":
               {
                   "kaspersky":
                   {
                       "enable": true,
                       "imap": true,
                       "pop3": true,
                       "smtp": true
                   }
               },
               "ssl":
               {
                   "inspection":
                   {
                       "enable": false,
                       "inspectSubDomain": true,
                       "showWarning": true,
                       "exceptions":
                       [
                           {
                               "custom": false,
                               "name": "ssl inspection exceptions",
                               "whitelist":
                               [
                                   "www.site.com"
                               ]
                           }
                       ]
                   },
                   "connectionFilter":
                   {
                       "enable": false,
                       "includeSubDomain": false,
                       "restrictSelfSignedCert": false,
                       "restrictSslCert": false,
                       "exceptions":
                       [
                           {
                               "blacklist":
                               [
                                   "www.site.com"
                               ],
                               "custom": false,
                               "name": "ssl connection exceptions"
                           }
                       ]
                   }
               }
           },
           "lastModified": "05:13:2014 11:09:58"
       }
   ],
   "default": false,
   "createdAt": "string",
   "lastModified": "string",
   "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
}

Response JSON

{
   "name": "put policies",
   "description": "string",
   "enabled": true,
   "activeVersion": "0.1",
   "versions":
   [
       {
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
           "version": "0.0",
           "config":
           {
               "web":
               {
                   "contentFilter":
                   {
                       "enable": true,
                       "commtouch":
                       {
                           "blockedList":
                           [
                               2,
                               3,
                               4
                           ],
                           "enable": false,
                           "name": "default"
                       },
                       "safesearch":
                       {
                           "enable": false
                       },
                       "customFilter":
                       {
                           "blacklist":
                           [
                               "www.site.com"
                           ],
                           "custom": false,
                           "name": "Default Policy Exception",
                           "whitelist":
                           [
                               "www.site.com"
                           ]
                       },
                       "kaspersky":
                       {
                           "download": true,
                           "enable": true,
                           "upload": true
                       }
                   }
               },
               "mail":
               {
                   "kaspersky":
                   {
                       "enable": true,
                       "imap": true,
                       "pop3": true,
                       "smtp": true
                   }
               },
               "ssl":
               {
                   "inspection":
                   {
                       "enable": false,
                       "inspectSubDomain": true,
                       "showWarning": true,
                       "exceptions":
                       [
                           {
                               "custom": false,
                               "name": "ssl inspection exceptions",
                               "whitelist":
                               [
                                   "www.site.com"
                               ]
                           }
                       ]
                   },
                   "connectionFilter":
                   {
                       "enable": false,
                       "includeSubDomain": false,
                       "restrictSelfSignedCert": false,
                       "restrictSslCert": false,
                       "exceptions":
                       [
                           {
                               "blacklist":
                               [
                                   "www.site.com"
                               ],
                               "custom": false,
                               "name": "ssl connection exceptions"
                           }
                       ]
                   }
               }
           },
           "lastModified": "05:13:2014 11:09:58"
       },
       {
           "id": "8e35756e-efaf-47f2-b803-19829bf8b7ab",
           "version": "0.1",
           "config":
           {
               "web":
               {
                   "contentFilter":
                   {
                       "enable": true,
                       "commtouch":
                       {
                           "blockedList":
                           [
                               12,
                               13,
                               14
                           ],
                           "enable": false,
                           "name": "default"
                       },
                       "safesearch":
                       {
                           "enable": false
                       },
                       "customFilter":
                       {
                           "blacklist":
                           [
                               "www.site.com"
                           ],
                           "custom": false,
                           "name": "Default Policy Exception",
                           "whitelist":
                           [
                               "www.site.com"
                           ]
                       },
                       "kaspersky":
                       {
                           "download": true,
                           "enable": true,
                           "upload": true
                       }
                   }
               },
               "mail":
               {
                   "kaspersky":
                   {
                       "enable": true,
                       "imap": true,
                       "pop3": true,
                       "smtp": true
                   }
               },
               "ssl":
               {
                   "inspection":
                   {
                       "enable": false,
                       "inspectSubDomain": true,
                       "showWarning": true,
                       "exceptions":
                       [
                           {
                               "custom": false,
                               "name": "ssl inspection exceptions",
                               "whitelist":
                               [
                                   "www.site.com"
                               ]
                           }
                       ]
                   },
                   "connectionFilter":
                   {
                       "enable": false,
                       "includeSubDomain": false,
                       "restrictSelfSignedCert": false,
                       "restrictSslCert": false,
                       "exceptions":
                       [
                           {
                               "blacklist":
                               [
                                   "www.site.com"
                               ],
                               "custom": false,
                               "name": "ssl connection exceptions"
                           }
                       ]
                   }
               }
           },
           "lastModified": "05:13:2014 11:18:56"
       }
   ],
   "default": false,
   "createdAt": "string",
   "lastModified": "string",
   "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
}

GET Policies API

Verb       URI                          Description
GET	       /domains/:id/policies    	  List summary of policies configuration in domains.

Example Request and Response

Response JSON

[
   {
       "name": "string",
       "description": "string",
       "enabled": true,
       "activeVersion": "0.0",
       "versions":
       [
           {
               "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
               "version": "0.0",
               "config":
               {
                   "web":
                   {
                       "contentFilter":
                       {
                           "enable": true,
                           "commtouch":
                           {
                               "blockedList":
                               [
                                   2,
                                   3,
                                   4
                               ],
                               "enable": false,
                               "name": "default"
                           },
                           "safesearch":
                           {
                               "enable": false
                           },
                           "customFilter":
                           {
                               "blacklist":
                               [
                                   "www.site.com"
                               ],
                               "custom": false,
                               "name": "Default Policy Exception",
                               "whitelist":
                               [
                                   "www.site.com"
                               ]
                           },
                           "kaspersky":
                           {
                               "download": true,
                               "enable": true,
                               "upload": true
                           }
                       }
                   },
                   "mail":
                   {
                       "kaspersky":
                       {
                           "enable": true,
                           "imap": true,
                           "pop3": true,
                           "smtp": true
                       }
                   },
                   "ssl":
                   {
                       "inspection":
                       {
                           "enable": false,
                           "inspectSubDomain": true,
                           "showWarning": true,
                           "exceptions":
                           [
                               {
                                   "custom": false,
                                   "name": "ssl inspection exceptions",
                                   "whitelist":
                                   [
                                       "www.site.com"
                                   ]
                               }
                           ]
                       },
                       "connectionFilter":
                       {
                           "enable": false,
                           "includeSubDomain": false,
                           "restrictSelfSignedCert": false,
                           "restrictSslCert": false,
                           "exceptions":
                           [
                               {
                                   "blacklist":
                                   [
                                       "www.site.com"
                                   ],
                                   "custom": false,
                                   "name": "ssl connection exceptions"
                               }
                           ]
                       }
                   }
               },
               "lastModified": "05:13:2014 11:09:58"
           }
       ],
       "default": false,
       "createdAt": "string",
       "lastModified": "string",
       "id": "540900a4-73d7-45e7-8683-7238e0d13bf1"
   }
]

PUT Plocies API

Verb       URI                          Description
PUT	       /domains/:id/policies/:pid	  Update policies configuration by PID.

On success it returns JSON data with the UUID for the policies upadted configuration in domains by policies ID.

Example Request and Response

Request JSON

{
   "name": "put policies",
   "description": "string",
   "enabled": true,
   "activeVersion": "0.0",
   "versions":
   [
       {
           "id": "540900a4-73d7-45e7-8683-7238e0d13bf1",
           "version": "0.0",
           "config":
           {
               "web":
               {
                   "contentFilter":
                   {
                       "enable": true,
                       "commtouch":
                       {
                           "blockedList":
                           [
                               12,
                               13,
                               14
                           ],
                           "enable": false,
                           "name": "default"
                       },
                       "safesearch":
                       {
                           "enable": false
                       },
                       "customFilter":
                       {
                           "blacklist":
                           [
                               "www.site.com"
                           ],
                           "custom": false,
                           "name": "Default Policy Exception",
                           "whitelist":
                           [
                               "www.site.com"
                           ]
                       },
                       "kaspersky":
                       {
                           "download": true,
                           "enable": true,
                           "upload": true
                       }
                   }
               },
               "mail":
               {
                   "kaspersky":
                   {
                       "enable": true,
                       "imap": true,
                       "pop3": true,
                       "smtp": true
                   }
               },
               "ssl":
               {
                   "inspection":
                   {
                       "enable": false,
                       "inspectSubDomain": true,
                       "showWarning": true,
                       "exceptions":
                       [
                           {
                               "custom": false,
                               "name": "ssl inspection exceptions",
                               "whitelist":
                               [
                                   "www.site.com"
                               ]
                           }
                       ]
                   },
                   "connectionFilter":
                   {
                       "enable": false,
                       "includeSubDomain": false,
                       "restrictSelfSignedCert": false,
                       "restrictSslCert": false,
                       "exceptions":
                       [
                           {
                               "blacklist"