Acen service (acen.asmx) offers methods for managing activation center clients, orders, licenses and web licenses.

Authentication

Service authentication is implemented via custom SOAP headers.

To use SOAP headers for authentication, a Web service client would send its credentials to the Web service by adding the expected SOAP header to the SOAP request and populating it with the client credentials.

Both clients and administrators can use activation web service. For example, clients can manage licenses for their orders only. On the other hand, administrators can manage licenses for any order.

Some methods can not be used by clients (please see security note for each method) for security reasons.

STATUS_AUTHORIZATION_ERROR is returned in case invalid credentials are provided.

STATUS_CREDENTIALS_MISSING is returned in case username and/or password is missing.

NOTE: Authentication is not required for web licensing methods.

VB.NET Web service authentication example

' service declaration definition
' localhost is web reference to acen.asmx service

Dim Service As New localhost.AcenService()

' authentication header definition

Dim AuthHeader As New localhost.ServiceAuthHeader

' Username and password are set in the following way:

AuthHeader.Username = "username"
AuthHeader.Password = "password"

Service.ServiceAuthHeaderValue = AuthHeader

Sample service client application

Sample service client (VS 2010 VB.NET project) is included in product distribution. This client will demonstrate basic usage all available service methods.

Project archive (acenservice.zip) is located  in \help subdirectory of ACEN.

NOTE:

- By default, localhost web reference point to service at: http://localhost/acen/acen.asmx. Please be sure to change it to reflect your custom setup.