Created by lissensj on May 21, 2014
Description: Retrieves the complete policy of a single realm from the Qeo administrator
It returns the policy per user of the realm.
URL Structure: https://my.qeo.org/qeo-rest-service/v1/realms/{id}/policy 
HTTP Method: GET
Parameter:

HTTP Authorization

Path parameter:
    identifier of the realm to be interrogated (value is of type long)

Request Example
https://my.qeo.org/qeo-rest-service/v1/realms/103/policy
Response:

HTTP 200 OK
Content-Type: application/json

Body: Contains a list of users with their list of policy rules and associated access rights in JSON format:
         {"users":[{"user":...,"type":"user","policy":[{"name":"..","type":"policy_rule","read_access":{"users":[...]},
           "write_access":{"users":[...]} }, {...}] },{...}]}

          The returned parameters on user level: 
              "user"   : value of type long, representing the user identifier
              "type"   : type of object returned (always "user")
              "policy" : list of policy rules applicable for the specified user

          The returned parameters on policy level:
              "name" : UTF-8 string representing the policy rule
              "type"   : type of object returned (always "policy_rule")
              "users" : list of users identifiers (values of type long), where the policy rule belongs to
              "realm" : value of type long, represents the realm identifier
              "read_access" : determines read access of users on the policy rule
                        null     : no read access for the policy rule
                       "users" : list of user identifiers of type long
                                    possible values: null : no read access for the policy rule
                                                                [] : empty array: coarse grained read access for the policy rule
                                                            [1,3] : filled array: fine grained read access for the policy rule
              "write_access" : determines write access of users on the policy rule
                        null     : no write access for the policy rule
                       "users" : list of user identifiers of type long
                                    possible values: null : no write access for the policy rule
                                                                [] : empty array: coarse grained write access for the policy rule
                                                            [1,3] : filled array: fine grained write access for the policy rule

Response Example
{
   "users":[{
             "user":1444,
             "type":"user",
             "policy":[{
                         "name":"org::qeo::QNote::topic1::*",
                         "type":"policy_rule",
                         "users":[1444],
                         "realm":103,
                         "read_access":{
                                          "users":[1444,255,66548]
                                       },
                         "write_access":{
                                          "users":[1444,255,66548]
                                        }
                       },{
                         "name":"org::qeo::QNote::topic6::*", 
                         "type":"policy_rule",
                         "users":[1444],
                         "realm":103,
                         "read_access":{
                                         "users":[]
                                       },
                         "write_access":null
                       }]
            },{
             "user":255,
             "type":"user",
             "policy":[{
                         "name":"my::hello::world::topic5::*",
                         "type":"policy_rule",
                         "users":[255]
                         "realm":103,
                         "read_access":null,
                         "write_access":{
                                          "users":null
                                        }
                       },{
                         "name":"org::qeo::QNote::topic9::*", 
                         "type":"policy_rule",
                         "users":[255],
                         "realm":103,
                         "read_access":null,
                         "write_access":null
                       }]
            },{
             "user":66548,
             "type":"user",
             "policy":[{
                         "name":"my::hello::world::topic2::*",
                         "type":"policy_rule",
                         "users":[66548],
                         "realm":103,
                         "read_access":{
                                         "users":[66548,255]
                                       },
                         "write_access":{
                                          "users":[255]
                                        }
                       },{
                         "name":"org::qeo::QNote::topic4::*", 
                         "type":"policy_rule",
                         "users":[66548],
                         "realm":103,
                         "read_access":{
                                         "users":null
                                       },
                         "write_access":{
                                          "users":[]
                                        }
                       }]
            }]
}