How to Disable VMware Plugins in vCenter Server per VMSA-2021-0002, VMSA-2021-0010, VMSA-2021-0010
search cancel

How to Disable VMware Plugins in vCenter Server per VMSA-2021-0002, VMSA-2021-0010, VMSA-2021-0010

book

Article ID: 317705

calendar_today

Updated On:

Products

VMware vCenter Server

Issue/Introduction

Vulnerabilities in plugins that ship with vCenter Server have been disclosed by VMware. These vulnerabilities and their impact on VMware products are documented in the following VMware Security Advisories (VMSAs), please review these documents before continuing:
  • CVE-2021-21972 - VMSA-2021-0002 (vRealize Operations Manager Plugin)
  • CVE-2021-21985 - VMSA-2021-0010 (Virtual SAN Health Check Plugin)
  • CVE-2021-21986 - VMSA-2021-0010 (Virtual SAN Health Check, Site Recovery, vSphere Lifecycle Manager, and VMware Cloud Director Availability Plugins)

VMware has investigated these issues and has determined that the possibility of exploitation can be removed via disablement of impacted plugins by performing the steps detailed in the Workaround section of this article.

Resolution

The workarounds described in this document are meant to be a temporary solution only.
Upgrades documented in the aforementioned advisories should be applied to resolve vulnerabilities in impacted plugins.

Workaround:
Important: Plugins must be set to "incompatible." Disabling a plugin from within the UI does not prevent exploitation.

The following actions must be performed on both the active and passive nodes in environments running vCenter High Availability (VCHA).

The examples documented here show the steps to disable all plugins which have been impacted by vulnerabilities disclosed by VMware. Depending on your environment and your requirements, you may only want to only disable a subset of these plugins. 
Please see the
VMSA-2021-0010: What You Need to Know blog to determine the plugins that are required to be disabled in your configuration.

Add the lines below to the compatibility-matrix.xml file to disable each individual plugin:
Plugin NameConfiguration Line
VMware vRops Client Plugin<PluginPackage id="com.vmware.vrops.install" status="incompatible"/>
VMware vSAN H5 Client Plugin<PluginPackage id="com.vmware.vsphere.client.h5vsan" status="incompatible"/>
Site Recovery<PluginPackage id="com.vmware.vrUi" status="incompatible"/>
VMware vSphere Life-cycle Manager<PluginPackage id="com.vmware.vum.client" status="incompatible"/>
VMware Cloud Director Availability<PluginPackage id="com.vmware.h4.vsphere.client" status="incompatible"/>

Some plugins are enabled by default, and these default plugins differ from version to version.
Please refer to the table below to determine which plugin is enabled by default and which plugin requires the associated product to be installed and configured.

Default = Plugin is enabled by default on all vCenter installations 
Product = Plugin is enabled only when the associated product is installed and configured
 
vCenter VersionvRealize OperationsvSANVMware vSphere Life-cycle ManagerSite RecoveryVMware Cloud Director Availability
6.5DefaultDefault (6.5 U3k and later) N/AProductProduct
6.7DefaultDefaultN/AProductProduct
7.0DefaultDefaultDefaultProductDefault


To implement the workaround, follow the steps applicable for your type of vCenter Server deployment.
Quick links:

 

Disable vCenter Server plugins on Linux-based virtual appliances (vCSA)

  1. Connect to the vCSA using an SSH session and root credentials.
  2. Backup the /etc/vmware/vsphere-ui/compatibility-matrix.xml file:
cp -v /etc/vmware/vsphere-ui/compatibility-matrix.xml /etc/vmware/vsphere-ui/compatibility-matrix.xml.backup
  1. Open the compatibility-matrix.xml file in a text editor:
vi /etc/vmware/vsphere-ui/compatibility-matrix.xml

Note: Content of an unedited file should look similar to the following:
Example of an unedited compatibility-matrix.aml.backup file.
  1. To disable all plugins with disclosed vulnerabilities, add the following lines as shown below:
Note: These entries should be added between the --> and <!— entries highlighted above.

<PluginPackage id="com.vmware.vrops.install" status="incompatible"/>
<PluginPackage id="com.vmware.vsphere.client.h5vsan" status="incompatible"/>
<PluginPackage id="com.vmware.vrUi" status="incompatible"/>
<PluginPackage id="com.vmware.vum.client" status="incompatible"/>
<PluginPackage id="com.vmware.h4.vsphere.client" status="incompatible"/>

Note: The file should like below:
Example of an edited compatibility-matrix.aml.backup file.
  1. Save and close the compatibility-matrix.xml file:
:wq!
  1. Stop and restart the vsphere-ui service using these commands: 
service-control --stop vsphere-ui
service-control --start vsphere-ui

From the vSphere Client (HTML5), the VMware Virtual SAN Health Check Plugin can be seen as incompatible under Administration > Solutions > client-plugins as shown below:
 
For vSphere 7.0:

7.0View.jpg


For vSphere 6.7:

6.7View.jpg

 

Disable vCenter Server plugins on Windows-based vCenter Server deployments

  1. RDP to the windows based vCenter Server.
  2. Take a backup of the C:\ProgramData\VMware\vCenterServer\cfg\vsphere-ui\compatibility-matrix.xml file.
  3. Open the compatibility-matrix.xml file in a text editor:
Note: Content of an unedited file should look similar to the following:
Example of an unedited compatibility-matrix.aml.backup file.
  1. To disable all plugins with disclosed vulnerabilities, add the following lines as shown below:
Note: These entries should be added between the --> and <!— entries highlighted above

<PluginPackage id="com.vmware.vrops.install" status="incompatible"/>
<PluginPackage id="com.vmware.vsphere.client.h5vsan" status="incompatible"/>
<PluginPackage id="com.vmware.vrUi" status="incompatible"/>
<PluginPackage id="com.vmware.vum.client" status="incompatible"/>
<PluginPackage id="com.vmware.h4.vsphere.client" status="incompatible"/>

Note: The file should look like below:
Example of an edited compatibility-matrix.xml file.
  1. Save and close the file.
  2. In a Windows command prompt, stop and restart the vsphere-ui service using these commands:
C:\Program Files\VMware\vCenter Server\bin> service-control --stop vsphere-ui
C:\Program Files\VMware\vCenter Server\bin> service-control --start vsphere-ui

From the vSphere Client (HTML 5), the disabled plugins can be seen as incompatible under Administration > Solutions > client-plugins as shown below:

Example of Administration > client-plugins

Additional Information

For up-to-date information as well as future security information please sign up for VMware Security Advisory announcements at our mailing list portal. RSS feeds are also available on the advisories themselves.

Revert the Workaround
To revert the workaround, follow the steps applicable for your type of vCenter Server deployment.
Quick links:

 Revert the workaround on Linux-based virtual appliances (vCSA)

  1. Connect to the vCSA with an SSH session and root credentials.
  2. Open the compatibility-matrix.xml file in a text editor:
vi /etc/vmware/vsphere-ui/compatibility-matrix.xml
  1. Remove the below line in the file. 
<PluginPackage id="com.vmware.vrops.install" status="incompatible"/>
    <PluginPackage id="com.vmware.vsphere.client.h5vsan" status="incompatible"/>
    <PluginPackage id="com.vmware.vrUi" status="incompatible"/>
    <PluginPackage id="com.vmware.vum.client" status="incompatible"/>
    <PluginPackage id="com.vmware.h4.vsphere.client" status="incompatible"/>
  1. Save and close the file:
:wq!
  1. Stop and restart the vsphere-ui service using these commands: 
  • service-control --stop vsphere-ui.
  • service-control --start vsphere-ui
  1. Validate that the vsphere-ui service is up.
For more information on how to start/stop/restart services see:  

Revert the workaround on Windows-based vCenter Server deployments

  1. Connect to the Windows vCenter Server.
  2. Open C:\ProgramData\VMware\vCenterServer\cfg\vsphere-ui\compatibility-matrix.xml using a text editor.
  3. Remove the below line in the file.
<PluginPackage id="com.vmware.vrops.install" status="incompatible"/>
<PluginPackage id="com.vmware.vsphere.client.h5vsan" status="incompatible"/>
<PluginPackage id="com.vmware.vrUi" status="incompatible"/>
<PluginPackage id="com.vmware.vum.client" status="incompatible"/>
<PluginPackage id="com.vmware.h4.vsphere.client" status="incompatible"/>
  1. Save and close the file.
  2. In a Windows command prompt, stop and restart the vsphere-ui service using these commands: 
  • C:\Program Files\VMware\vCenter Server\bin> service-control --stop vsphere-ui
  • C:\Program Files\VMware\vCenter Server\bin> service-control --start vsphere-ui
  1. Validate that the vsphere-ui service is up.
For more information on how to start/stop/restart services see:

Impact/Risks:
Functionality impacts are limited to environments that utilize VMware plugins. Disablement of these plugins will result in a loss of management and monitoring capabilities provided by the plugins.