XML Activation Service

Existing customers can refer to the SOLO Server New Activation Features whitepaper for more information on these new web services.

The XML Activation Service web service provides several activation related web methods.  The current live server can be reached at https://secure.softwarekey.com/solo/webservices/XmlActivationService.asmx.  If you are running a stand alone version of SOLO server, simply replace secure.softwarekey.com/solo in the url with the path to your SOLO instance.

To ease implementing the XML Activation Service into your applications, we offer a .NET component that simplifies calling the web methods to just a few lines of code.  If you are interested in this component, contact support@softwarekey.com and request ClientServices.dll.  (Note - support for this may not yet be available in ClientServices.dll prior to official release of this functionality).

All web methods in this service use xml for both input and output (though the input parameter is defined as a string to allow POST access to the web service, the string must be in xml format).  This allows new input and output values to be added without breaking backwards compatibility with existing implementations using the service. If your integration with the web service validates the xml returned by the web methods, be sure to account for the possibility of new elements being returned in the result.  This can easily be done by applying an xslt transform to the result xml to filter out any new fields and then validating the transformed xml.

Each web method in this web service is documented by a series of documentation files named after the web method as follows:

• MethodNameInput.xml - Uncommented xml file with input xml structure.

• MethodNameInputDetails.xml - Commented xml file with input xml structure and comments on each input element.

• MethodNameInput.xsd - XSD schema file defining the input xml structure.

• MethodNameOutput.xml - Uncommented xml file with output xml structure.

• MethodNameOutputDetails.xml - Commented xml file with output xml structure and comments on each outputelement.

• MethodNameOutput.xsd - XSD schema file defining the input xml structure.

ActivateInstallation

This web method is used to perform an activation for an installation on a given license.  It returns activation codes and other license information related to activation.  The documentation files for this web method are as follows:

• ActivateInstallationInput.xml

• ActivateInstallationInputDetails.xml

• ActivateInstallationInput.xsd

• ActivateInstallationOutput.xml

• ActivateInstallationOutputDetails.xml

• ActivateInstallationOutput.xsd

ActivateInstallationLicenseFile

This web method is used to perform an activation for an installation on a given license.  It returns activation codes, other license information related to activation, and an XML License File for the PLUSManaged library.  PLUSManaged is a fully managed .NET class library for implementing licensing and activation into .NET applications. Digital signatures and public-key cryptography are used to protect a read-only XML license file issued by a SOLO Server.  Any new or existing Protection PLUS customers that are creating a new application in .NET may want to consider evaluating this new system. Contact us for more information.  The documentation files for this web method are as follows:

• ActivateInstallationLicenseFileInput.xml

• ActivateInstallationLicenseFileInputDetails.xml

• ActivateInstallationLicenseFileInput.xsd

• ActivateInstallationLicenseFileOutput.xml

• ActivateInstallationLicenseFileOutputDetails.xml

• ActivateInstallationLicenseFileOutput.xsd

DeactivateInstallation

This web method is used to deactivate an installation activated through the ActivateInstallation web method.  The documentation files for this web method are as follows:

• DeactivateInstallationInput.xml

• DeactivateInstallationInputDetails.xml

• DeactivateInstallationInput.xsd

• DeactivateInstallationOutput.xml

• DeactivateInstallationOutputDetails.xml

• DeactivateInstallationOutput.xsd

CheckInstallationStatus

This web method is used to retrieve installation status information for installations activated through the ActivateInstallation web method, as well as to post usage data to be logged on the server.  Note that the UsageData element is optional, but if specified can contain any number of LogEntry elements.  The documentation files for this web method are as follows:

• CheckInstallationStatusInput.xml

• CheckInstallationStatusInputDetails.xml

• CheckInstallationStatusInput.xsd

• CheckInstallationStatusOutput.xml

• CheckInstallationStatusOutputDetails.xml

• CheckInstallationStatusOutput.xsd

Note that all date values returned by these web methods are in UTC time using the ISO 8601 format as follows:

• YYYY-MM-DDTHH:MM.SSZ