VMware VSHIELD APP 1.0.0 UPDATE 1 - API Programming Manual page 61

7
vShield Endpoint Management
The VMware Endpoint system delivers an introspection-based antivirus solution that uses the hypervisor to
scan guest virtual machines from the outside with only a thin agent on each guest virtual machine.
You installed the vShield Endpoint service as part of ESX host preparation. You must perform the following
tasks in sequence to complete EPSec installation.
I All vShield REST requests require authorization. You can use the following basic authorization:
MPORTANT
Authorization: Basic YWRtaW46ZGVmYXVsdA==
YWRtaW46ZGVmYXVsdA== represents the Base 64 encoding of the vShield Manager default login credentials
(admin:default).
Register an SVM with the vShield Endpoint Service on an ESX Host
You can register and unregister a third-party antivirus security virtual machine (SVM) with vShield Endpoint.
In the POST request, vmId is the 0-based index of the vNIC that the SVM uses to communicate with the vShield
Endpoint service. The vShield Manager connects the vNIC to the correct port group to enable communication
between the SVM and the vShield Endpoint service.
To register SVMs on multiple ESX hosts in a single REST call, include multiple <SvmRegister /> sections in
the request body.
Example 7-1. Registering an SVM with vShield Endpoint Service
Request:
POST <vshieldmanager-uri>/api/1.0/endpointsecurity/svm
<VShieldEndpointSecurity>
<SvmRegister>
<vmId>vmid_of_svm_vm</vmId>
<ipAddress>ipaddress_of_svm_vnic</ipAddress>
<port>port_for_communication</port>
<vendorId>partner_identification_string</vendorId>
</SvmRegister>
</VShieldEndpointSecurity>
Where:

vmId is the SVM managed object ID in vCenter.

ipAddress is the IP address of the SVM's vNIC that is connected to the vmkernel port group.

port is the port on which the SVM listens to connection from the EPSec vmkernel module.

vendorId is the string that is used as an identifier of the partner who owns the SVM.
VMware, Inc.
7
61