Allows Qualys users to complete the registration process and accept the Qualys End User License Agreement (EULA) on behalf of their customers. This API provides programmatic acceptance of the Qualys EULA. This API does not support session based authentication.
The Qualys End User Licence Agreement (EULA) must be accepted with basic authentication. Once accepted, msp and VM, PA/PC APIs from V2.0 onwards work with JWT token authentication. Otherwise, it returns an ACCESS DENIED error.
A new user can complete the registration process and accept the Qualys EULA through the Qualys user interface as long as their account is granted the GUI access method. (Note a new user created using the user.php function is automatically granted the GUI and API access methods.) Optionally, a new user can complete the registration and accept the Qualys EULA using the acceptEULA.php function. Refer Change Login Password.
How it works - A Web application that allows Qualys EULA acceptance can be setup as follows. Inside the third party web application, a developer can setup a Web form that displays the Qualys EULA and has an "I Accept" button. A new Qualys user opens the Web form in a browser, reads the EULA description and clicks “I Accept” in the Web form. The third party’s program submits an HTTP request to the Qualys API server using the acceptEULA.php. Along with the acceptEULA.php URL, the application must send Qualys user account credentials (login and password) as part of the HTTP request.
Permissions - Users can use the accepteula.php API to complete registration and accept the Qualys EULA, including Manager, Unit Manager, Administrator, Scanner, Reader, Auditor.
API Request
https://<qualys_base_url>/msp/acceptEULA.php
XML Output
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE GENERIC_RETURN SYSTEM "https://<qualys_base_url>/generic_return.dtd"> <GENERIC_RETURN> <API name="acceptEULA.php" username="rob" at="2018-04-10T13:44:23" /> <RETURN status="SUCCESS"> TNC accepted within MSP </RETURN> </GENERIC_RETURN>
<platform API server>/generic_return.dtd