Managing Web Service Users
Web service operation requests must specify a valid web service user. All web service user management is performed on the Users
tab in the xMatters web user interface.
Web services access
Web service users can access only data specific to their
Company; otherwise their data visibility does not have limits that
may be enforced by other Roles, such as Group Supervisor. All data is returned as though
the request was made by an Administrator with visibility to all the data.
Multiple-Company deployments have an exception to the above rule when a User is created for an integration agent in the host Company (the "Default Company"), and the integration agent is allowed to interact with all of the tenant Companies in the deployment. This feature is controlled by the Service Provider Access check box on the Web Service Users details page in the xMatters web user interface. This check box is visible to host-Company Users only.
Adding and modifying Web Service Users
Company Administrators and Users with the Web Service Supervisor
Role have the ability to administer web service users. When
adding or modifying a web service user, you can specify which web services
the User is allowed to use.
When you add a Web Services license to a new or existing xMatters installation, a default web service user account is created with the following
credentials:
- User ID: IA_User
- Password: ia_complex
- Allowed Web Services:
Submit APXML, Receive APXML, Register Integration Agent
It is recommended that you change the password for this User, or disable
the account, once you have added the web service users for your Company.
To add a Web Service User:
- Specify a User
ID, Description (optional),
and Password.
- If you are creating a User for an integration agent and you want the integration agent to be able to interact with all of the Companies in your deployment, select the Service Provider Access check box. For more information about integration agent web services users, see the xMatters Integration Agent Guide.
- This check box is not visible to tenant Company Administrators, or on single Company deployments.
- In the Denied Web Services list, select the web services the User should be allowed
to access (Ctrl+click or Shift+click to select multiple web services),
and then click Add.
- If you are creating a web services user that will be used by an integration agent, you must select the Receive APXML, Register Integration Agent, and Submit APXML web services.
- To deny access to a web service, select it
in the Allowed Web Services list,
and then click Remove.
- Click Save.
To modify or delete a Web Service User:
- Click the Users
tab, and then click Find Web Service
Users.
- Use the search page to find the web service user
you want to modify or delete.
- In the Results table, do one of the following:
- To modify details for an existing Web Service
User, click the associated link in the User ID column, specify the new
details, and then click Save.
- To delete a Web Services User, select the
associated check box and click Remove
Selected.