Ametek UPLC-II System Manual page 180

UPlC-ii™ System manual
Basics of Management Services
The main purpose of the management user is to be
able to access web services on the UPLC-II directly,
rather than go through interactive graphically ori-
ented web pages to accomplish tasks.
The web services are built around the basic HTTP
interface. For those services requiring parameters,
the parameters are added to the request URL in a
HTTP query string. This means that appended to the
URL separated by a ? are a series of name/value
pairs that become the parameters (the input data) to
the service.
For more information on query strings, please see
http://en.wikipedia.org/wiki/Query_string
Following are the web services implemented on the
current version of UPLC-II firmware and descrip-
tions for use.
In the following descriptions, the form represents
the input as typed into a web browser.
Since the UPLC-II system enforces basic authoriza-
tion for access to these services, it is necessary to
supply the management users' credentials when
using the browser as the access device.
For automated user agents, it is possible to establish
a connection to the UPLC and access the service
Page D–2
Figure D–1. Creating a Management User
directly, supplying the credentials as part of the get
request as "Authorization: Basic <uuencoded cre-
dentials>".
The user credentials are in the form username:pass-
word, and then encoded.
The form of the get request aside from the addition
of Basic Authorization is beyond the scope of this
document. All required parameters for the get
request must be included.
Note: The following examples are derived from
using Internet Explorer to access the management
interface. This is done for clarity. The design of this
interface allows access from other user agents such
as .NET or other programmatic interfaces.
Authentication
For all management interface accesses, the request
must include the username and password of the
management user as part of the request.
If the username and password are not included as
part of the request, or the username and password
are not correct, the UPLC-II returns the standard
HTTP 1.1 message: "401 Unauthorized - User
authentication is required."