Authentication
The Platform Administrative Web services uses the HTTPS Basic Authentication scheme, and all PAWS API calls require authentication. You can use the account created during installation to authenticate API calls, or you can use the command line interface (CLI) to create a new account for PAWS administration.
To create an account using the CLI, run the following commands:
admin:set account name pawsadmin
Privilege Levels are:
Ordinary - Level 0
Advanced - Level 1
Please enter the privilege level :0
Please enter the password :*******
re-enter to confirm :*******
Account successfully created
Check the CLI Reference Guide for Unified CM for more information about the command line interface commands.
You must include the Authorization header in the HTTPS header. Base64 encoding takes three 8-bit bytes and represents them as four printable ASCII characters. If the encoded header does not contain an even multiple of four ASCII characters (16, 20, 24, and so on), you must add padding characters (=) to complete the final group of four.
If user authentication of the user fails, the system returns an HTTP 401 Access Denied error to the client. For example, if the user wants to send the userid “joeblogs” and password “test123,” it use the following header field:
Authorization: Basic am9lYmxvZ3M6dGVzdDEyMw==
where the string “am9lYmxvZ3M6dGVzdDEyMw==” provides the Base64 encoding of “larry:curly and moe.” Note that the two “equals” (=) characters at the end of the string act as padding characters for Base64 encoding.
Because PAWS uses HTTPS, you will need to enable SSL support in your application. Depending on the specific technology used by your application, you may need to manually install the Unified Communication application's self signed certificate into a local truststore for your application.