Request address

http://ip:port/bi/api?action=setAuthorization&type=combine&token=xxxx

Request message

Request parameter

required parameter:xmlData (required)

<?xml version="1.0" encoding="UTF-8"?>

<info>  

 <authorization>        

  <identity>                

   <ref>                        

  <type>user</type>                        

  <name>user1</name>                

 </ref>

   <ref>                        

    <type>group</type>                        

  <name>group-1</name>                

  <parent>group</parent>                

 </ref>

 <ref>                        

  <type>role</type>                        

  <name>test_role</name>                

 </ref>        

  </identity>                

  <rperm>                

 <ref>                        

  <type>Query</type>                

 </ref>                

 <ref>                        

  <type>db</type>                        

  <path>test</path>                

 </ref>                        

  </rperm>        

  <wperm>                

 <ref>                        

  <type>db</type>                        

  <path>test</path>                

 </ref>                                                        

  </wperm>                          

 </authorization>

</info>

parametric description

The parameter is node information:

1) identity-ref-type(required): The type of node to set,including three types: user, group, role.

2) identity-ref-name(required): The name of node.

3) identity-ref-parent(required):The path to when the node is group.

4) rperm(optional): Read Permission。

5) rperm-ref-type(required): The type of node, including resource type and operation type.

6) rperm-ref-path (required when setting read permission): Need to set the path of the node. When selecting the operation type, this item does not need to be filled.

7) wperm (optional): Write Permission.

8) wperm-ref-type (required when setting write permissions): Need to set the type of node, including resource type and operation type (see appendix).

9) wperm-ref-path (required when setting write permission): Need to set the path of the node. When selecting the operation type, this item does not need to be filled.

Explanation:

1) There can be multiple identity-refs, but at least one.

2) Fill in at least one of rperm and wperm.

3) This method will not overwrite the previous permission settings, and will add resource or operation permissions to the original permissions.

Sample

function setAuthorization() {

        var xml = getXml();

        $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setAuthorization&type=combine&token=xxxx",

           {xmlData : xml},

           function(result) {        

              writeXml(result);

           });

     }

Response message

Response result

1) Successful operation

<?xml version="1.0" encoding="UTF-8"?>

<results>

  <result>

         <level>1</level>

         <message>Operates successfully.</message>

  </result>

</results>

2) Operation failed

<?xml version="1.0" encoding="UTF-8"?>

<results>

 <result>

  <level>6</level>

  <message>The Users, Groups or Roles "user1" does not exist.</message>

 </result>

</results>

or

<?xml version="1.0" encoding="UTF-8"?>

 <results>

  <result>

   <level>6</level>

   <message>The resource or operation "test" could not be found. </message>

  </result>

 </results>

Result description

The response result information is xml. direct parse.

1) Level return type, different values represent different return status, see appendix.

2) Message is the interface operation result information.