HP CloudSystem Matrix/Matrix Operating Environment 7.0 Integration Interfaces API and CLI Operations Reference Guide

2 Accessing the Web Service Interfaces
Accessing WSDL
The Web Service Description Language or WSDL (See Reference [1]) definition of IO operations
can be accessed from any installed IO system using a web browser. For example, if the software
is installed on a server with IP address 192.168.0.25, then to access the WSDL type into the web
browser:
https://192.168.0.25:51443/hpio/controller/soap/v3?wsdl
The browser will show the formal XML definition of the Web Service Interface. The IO API is already
available in the embedded Operations Orchestration upon IO installation.
Security
The IO Web Service is only accessible over https. The service uses WS-Security UsernameToken
authentication in text form. A username and password of a registered IO user is required to access
the Web Service Interface. A WS-Security timestamp header is also required.
Authorization
If the presented username/password corresponds to a registered IO user who has the role of
Administrator, the web services are able to view and act on all services. For username/password
corresponding to registered users with the role of Architect or User, the web services are only able
to view or act on the services owned by that particular user.
The Activate Service operation (and others) specifies a list of server pools from which the servers
will be allocated. The set of available pools is based on the assignments of the requesting user
(not the service owner). For Administrator users, all pools except Maintenance and Unassigned
are available.
Impersonation
An “Impersonation” feature allows an authenticated Administrator role user to perform an operation
in the context of a specified requesting user. This behavior can be used in the implementation of
enterprise service catalogs to initiate operations on behalf of enterprise users. Impersonation is
achieved by including an HP-IO-Impersonate cookie in the HTTP message header. For example, if
the request includes the HTTP header “Cookie: HP-IO-Impersonate=Steve”, the operation will be
performed as though it were requested by Steve. A message is written to the audit log to record
the impersonation event.
Command Line Interface
An IO installation includes an “ioexec” command line interface (CLI) to access the IO Web Service.
The CLI may be useful for scripting web service invocations and for testing purposes when
developing a web service client. The CLI operations and data model mirror the Web Service
Interface. The CLI may be copied from an IO installation to a different system to operate on the
CMS remotely. The “ioexec” command help provides specific usage details.
Accessing WSDL 11