Update the ABRCA Root CA Certificate on ProxySG Appliances (Revised: September 7, 2021)

book

Article ID: 207152

calendar_today

Updated On:

Products

ProxySG Software - SGOS

Issue/Introduction

The Appliance Birth Registration Certificate Authority (ABRCA) root CA certificate is the ultimate root of trust for all appliance certificates that Symantec products use. Symantec has created a new ABRCA root CA certificate to replace the one expiring in December 2021. Before the older root CA certificate expires, ensure that the new root CA certificate is installed on your appliances. The new certificate will have an expiration date of Dec 31 00:04:16 2037 GMT.

Important: The continued operation of your ProxySG appliances requires that:

  • The system trust package is up to date.
  • The appliance certificate has not expired.
  • For virtual appliances, a new license file is installed.

Consequences of an Expired Appliance Certificate

If the appliance certificate expires, the following issues might occur:

  • ADN peer-to-peer communications on hardware platforms and MACH5 virtual appliances fail.
  • Downloads of almost all subscription service databases fail.
  • SGOS integration with SSLV offload functionality will fail.

Other issues, yet to be identified, might also occur. To prevent these issues from occurring, perform the applicable steps described below as soon as possible.

Recovery: What to Do If You Fail to Update Before the Certificate Expires

If you fail to update your ProxySG appliances before the root CA expires in December 2021, the appliances might experience failures as described above. To renew the certificate, follow the steps described in the Resolution section below.

Resolution

To ensure the uninterrupted operation of your ProxySG appliances, perform the following updates immediately; if this is not possible, make it a priority to complete the updates by the specified dates below. 

Appliance or application

Required updates

Update by

Instructions

Hardware platforms

Update the ABRCA root CA certificate. 

Upgrading SGOS first is recommended.

December 18, 2021

  1. Upgrade to a recommended release. See Recommended Upgrade.
  2. Ensure the latest trust package is installed. See Verify the Trust Package below.

Note: Retrieving a new appliance certificate is not required for updating the ABRCA root CA certificate; however, if you have to update the appliance certificate in the future, refer to KB article 168179. To update the appliance certificate in a closed environment, refer to KB article 222712.

Virtual appliances

 

Update the ABRCA root CA certificate and the appliance certificate.

Upgrading SGOS first is recommended. 

November 15, 2021

  1. Upgrade to a recommended release. See Recommended Upgrade.
  2. Ensure the latest trust package is installed. See Verify the Trust Package below.
  3. Ensure the latest license file is installed. See Update the ProxySG Virtual Appliance License File below.

 

Note: To update ProxySG applications on Integrated Secure Gateway (ISG), refer to Integrated Secure Gateway Birth Registration Certificate Authority (ABRCA) Root CA Certificate Update for instructions.

 

1. Recommended Upgrade

An upgrade is not required to update the ABRCA root CA on the ProxySG appliance, but for best security, upgrade to one of the following releases:

  • SGOS 6.7.5.12 and later
  • SGOS 7.2.7.2 and later
  • SGOS 7.3.3.3 and later

These releases include a critical security vulnerability fix; see SYMSA18331 for more information.

 

2. Verify the Trust Package

To verify if you have an appropriate trust package installed, use the following ProxySG command line interface (CLI) command:

#show security trust-package 

Download url: http://appliance.bluecoat.com/sgos/trust_package.bctp
Auto-update: enabled            
Auto-update interval: 7 days

Previous (success) install via manual

 Creation time: Tuesday October 13 2020 21:05:46 UTC

 CA Certificate List changes:
         browser-trusted: CAs - 28 added, 77 deleted, 2 modified

 image-validation install: Monday October 26 2020 15:34:34 UTC

Download log:
        Downloaded at: Tuesday May 11 2021 19:24:07 UTC          Success
        Downloaded from: http://appliance.bluecoat.com/sgos/trust_package.bctp

In the command output, look for the date beside "Creation time". If the date is "October 13, 2020" or later, no further steps are required to update the trust package for this appliance. 

Note: Updating SGOS to one of recommended versions listed above should also automatically update the trust package to a supported version. If the #show security trust-package command shows that the trust package is not updated after upgrading SGOS on the appliance, update the trust package manually; see the following instructions.

Download the Trust Package Manually

This step is only necessary if the appliance does not have a trust package dated October 13 2020 or later. Download the trust package by performing one of the following procedures, depending on your deployment:

If the appliance can access appliance.bluecoat.com, see Download the Trust Package from Symantec Servers. If the appliance is in a closed environment, see Update the Trust Package in a Closed Environment.

Download the Trust Package from Symantec Servers

To download the trust package manually, use the following ProxySG CLI command:

  #load trust-package
    Downloading from "http://appliance.bluecoat.com/sgos/trust_package.bctp"
    The trust package has been successfully downloaded.
    trust package successfully installed

After downloading the trust package, follow the instructions in Verify the Trust Package to ensure that the latest trust package is installed.

Update the Trust Package in a Closed Environment

In a closed environment, you must manually download the trust package and host it on a file server that the appliance can access. Then, on the ProxySG appliance, specify this file server location in the #load trust-package command: 

  1. Download the trust package from http://appliance.bluecoat.com/sgos/trust_package.bctp.
    If clicking the previous link does not initiate the download, right-click the link and select Save As to download the file.
  2. Save the trust package to a location in the local network that the appliance can access via HTTP.
  3. Specify the download URL and load the trust package:
# (config) security trust-package download-path <local_URL>
  ok
#(config) exit
# load trust-package
  Downloading from "http://your_domain/sgos/trust_package.bctp"
    The trust package has been successfully downloaded.
    trust package successfully installed

 

3. Update the ProxySG Virtual Appliance License File

Virtual appliances require a license file created after December 11, 2020. Because ProxySG virtual appliances automatically update the license every 30 days that the appliance is running, your appliances should have the latest license file unless they were restricted from accessing download.bluecoat.com or the license auto-update settings were changed from their defaults. 

Ensure Access to download.bluecoat.com

Ensure that the appliance can access download.bluecoat.com, as described in Required Ports, Protocols, and Services for Symantec Enterprise Security Products.

Enable Automatic License Updates

Note: This functionality is not yet available in the Admin Console.

To enable or confirm automatic license updates:

  1. In the Management Console, select the Maintenance > Licensing > Install tab. 

  2. If Use Auto-Update is not selected, select it. 

  3. Select Apply.

Verify the Virtual Appliance License File

To verify if you have an appropriate license file installed, follow the appropriate steps for the Management Console or the ProxySG Admin Console (SGOS 6.7.4 and later).

In the Management Console:

  1. Select Maintenance > Licensing > View.

  2. In the General Licensing Information area, look for the License creation date.  If the date is later than "2020-12-11", no further steps are required for this appliance.

Alternatively, use the CLI to check the license file:

#show licenses
The SG appliance is operating with a subscription license.
Subscription expiration date:  2020-12-03
Creation date:                 2021-03-03
Appliance serial number:      
Concurrent users:              unlimited
Maximum CPU count:             16
License validation enforced:   yes
License validation server:     connected
License validation state:      ok
 

In the command output, look for the "Creation date" line.  If the date is later than "2020-12-11", no further steps are required for this appliance. 

In the Admin Console:

  1. Select Administration > Licensing > Licensed Components and Subscriptions.

  2. In the View area, look for the License Creation date.  If the date is later than "2020-12-11", no further steps are required for this appliance. 

Alternatively, use the CLI to check the appliance-key certificate:

#show ssl keyring appliance-key
Keyring ID:               appliance-key
Private key showability:  no-show
Signing request:          absent
Certificate:              present
Certificate subject:      /C=US/ST=California/O=Blue Coat Systems, Inc./OU=Blue Coat SGVA Series/CN=1001598011
Certificate issuer:       /C=US/ST=California/L=San Jose/O=Broadcom Inc./OU=ABRCA/CN=Virtual Appliance Birth Certificate Intermediate CA
Certificate valid from:   Feb 24 08:33:40 2021 GMT
Certificate valid to:     Feb 25 16:33:40 2026 GMT
Certificate thumbprint:   89:D2:C9:19:58:05:B5:2B:A2:CC:5C:49:FE:DC:DD:F5
 

In the command output, look for the "Certificate issuer" line. If the "CN="  value is "Virtual Appliance Birth Certificate Intermediate CA", no further steps are required for this appliance.

Download the Virtual Appliance License File

This step is only necessary if the previous verification step indicated that you need to update to a new license file.

In the Management Console:

  1. Select Maintenance > Licensing > Install

  2. Select Retrieve. The console displays the Request License Key dialog. 

  3. Enter the following information: 

    1. Enter your myBroadcom account login information.

    2. Select Request License. The console displays the Confirm License Install dialog. 

    3. Select OK to begin license retrieval (the dialog closes). 

  4.  (Optional) Select Show results to verify a successful retrieval. If any errors occur, verify that the appliance can connect to download.bluecoat.com. 

  5. Select Close to close the Request License Key dialog. 

Alternatively, use the CLI to download the license file:

#licensing request-key
User ID: <myBroadcom_ID>
Password: <myBroadcom_password>
Downloading license-key file (block 0)
License install successful

 

In the Admin Console:

  1. Select Administration > Licensing > Licensed Components and Subscriptions.

  2. In the Install section, select Retrieve

  3. In the Retrieve License Key dialog, enter your myBroadcom account login information and select Request license

  4. (Optional) Select Show results to verify a successful retrieval. If any errors occur, verify that the appliance can connect to download.bluecoat.com. 

 

Attachments