License Server 12.13

# ShowPermissions

The `ShowPermissions` action returns information on whether a specified IP address is allowed to send query actions or administrative actions to the action port.

For users that belong to the `Admin` standard role (see Authorization Roles Configuration Parameters), the `ShowPermissions` response also includes information about the rules that are used to define whether a particular client IP address has particular permissions.

## Example

    action=ShowPermissions&IP=12.3.4.56

This action checks whether the machine with the IP address `12.3.4.56` is allowed to send actions to the port. If you send the action as a user that belongs to the `Admin` standard role, the action returns the following information:

      <?xml version="1.0" encoding="UTF-8" ?>
    - <autnresponse xmlns:autn="http://schemas.autonomy.com/aci/">
         <action>SHOWPERMISSIONS</action>
         <response>SUCCESS</response>
       - <responsedata>
        - <autn:rules>
          - <autn:queryclient>
              <autn:enabled>true</autn:enabled>
              <autn:origin>*</autn:origin>
            </autn:queryclient>
          - <autn:adminclient>
              <autn:enabled>true</autn:enabled>
              <autn:origin>*</autn:origin>
            </autn:adminclient>
          - <autn:allowedproxy>
              <autn:enabled>true</autn:enabled>
              <autn:origin>12.3.4.56</autn:origin>
              <autn:origin>::1</autn:origin>
              <autn:origin>127.0.0.1</autn:origin>
            </autn:allowedproxy>
          - <autn:servicestatusclient>
              <autn:enabled>true</autn:enabled>
              <autn:origin>*</autn:origin>
            </autn:servicestatusclient>
          - <autn:servicecontrolclient>
              <autn:enabled>true</autn:enabled>
              <autn:origin>*</autn:origin>
            </autn:servicecontrolclient>
          - <autn:indexclient>
              <autn:enabled>true</autn:enabled>
              <autn:origin>::1</autn:origin>
              <autn:origin>127.0.0.1</autn:origin>
            </autn:indexclient>
          - <autn:allowedindexproxy>
              <autn:enabled>true</autn:enabled>
              <autn:origin>12.3.4.56</autn:origin>
              <autn:origin>::1</autn:origin>
              <autn:origin>127.0.0.1</autn:origin>
            </autn:allowedindexproxy>
          </autn:rules>
        - <autn:requested>
            <autn:ip>12.3.4.56</autn:ip>
            <autn:ipvalid>true</autn:ipvalid>
            <autn:queryclient>true</autn:queryclient>
            <autn:adminclient>true</autn:adminclient>
            <autn:allowedproxy>true</autn:allowedproxy>
            <autn:servicestatusclient>true</autn:servicestatusclient>
            <autn:servicecontrolclient>true</autn:servicecontrolclient>
            <autn:indexclient>false</autn:indexclient>
            <autn:allowedindexproxy>true</autn:allowedindexproxy>
            <autn:cors>
               <autn:enabled>true</autn:enabled>
               <autn:origin>*</autn:origin>
            </autn:cors>
          </autn:requested>
         </responsedata>
      </autnresponse>

If you send the action as a user that does not belong to the `Admin` role, the action does not return the `<autn:rules>` section of the response.

Alternatively you can specify the action without an IP address, in which case License Server returns the permissions information for the referring IP address.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
IP | the IP address (in numeric format) that you want to show permissions for.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL License Server 12.13

Topic Title: ShowPermissions