WSA 9-0-x Release Notes
WSA 9-0-x Release Notes
WSA 9-0-x Release Notes
x for
Cisco Web Security Appliances
Published: September 21, 2015
Revised: March 8, 2016
Contents
Support, page 15
Whats New
Whats New
Whats New in Cisco AsyncOS 9.0.1-161 (GD - for physical appliances only), page 2
Description
Maximum HTTP
Header Size
Whats New in Cisco AsyncOS 9.0.1-161 (GD - for physical appliances only)
This build can be installed only on physical appliances; see the explanation in the previous section,
Whats New in Cisco AsyncOS 9.0.1-162 (GD).
Feature
Description
Maximum HTTP
Header Size
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Release Classification
Description
Secure ICAP
You can now secure the channel between the appliance and an external
DLP (ICAP) server.
TLS/SSL Configuration
For enhanced security, you can now enable and disable SSL v3 and
various versions of TLS for several services. Disabling SSL v3 for all
services is recommended for best security. You also can enable a
protocol fallback option.
Note
You can now control how incoming range requests are handled, on a
per-policy basis.
You can now view a listing of recent appliance access attempts, both
successes and failures, for your user name. When logging in via the CLI,
this information is displayed automatically on log-in. In the Web
interface, click the recent-activity (i or ! for success or failure icon
respectively) in front of the Logged in as entry in the upper right
corner of the application window.
Release Classification
Each release is identified by the release type (ED - Early Deployment, GD - General Deployment, etc.)
For an explanation of these terms, see
http://www.cisco.com/c/dam/en/us/products/collateral/security/web-security-appliance/content-securit
y-release-terminology.pdf.
Some hardware models require a memory upgrade before you can install or upgrade to this AsyncOS
release. For more information, see
http://www.cisco.com/c/en/us/support/docs/field-notices/638/fn63931.html
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Upgrade Paths
Upgrade Paths
Before you start the upgrade process, see Pre-Upgrade Requirements, page 6 and Installation and
Upgrade Notes, page 7.
Upgrading to AsyncOS 9.0.1-161 (GD - General Deployment; for physical appliances only), page 4
7.7.0-761
8.0.0-503
8.5.1-021
8.7.0-172
9.0.0-485
7.7.0-809
8.0.6-078
8.5.2-027
8.8.0-085
9.0.1-135
8.0.7-142
8.5.2-103
9.0.1-144
8.0.7-149
8.5.2-105
9.0.1-161
8.0.7-150
8.5.3-069
8.0.7-151
8.0.7-152
8.0.8-113
8.0.8-118
8.0.8-401
8.1.0-235
Upgrading to AsyncOS 9.0.1-161 (GD - General Deployment; for physical appliances only)
You can upgrade to release 9.0.1-161 for AsyncOS for Cisco Web Security appliances from the
following versions:
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Upgrade Paths
7.7.0-761
8.0.0-503
8.5.1-021
8.7.0-172
9.0.0-485
7.7.0-809
8.0.6-078
8.5.2-027
8.8.0-085
9.0.1-135
8.0.7-142
8.5.2-103
9.0.1-144
8.0.7-149
8.5.2-105
8.0.7-150
8.5.3-069
8.0.7-151
8.0.7-152
8.0.8-113
8.0.8-118
8.0.8-401
8.1.0-235
If your organization uses time and volume quotas, Cisco does not recommend upgrading to this release.
For information, see https://tools.cisco.com/bugsearch/bug/CSCux58919.
You can upgrade to release 9.0.1-135 for AsyncOS for Cisco Web Security appliances from the
following versions:
7.7.0-761
8.0.0-503
8.5.1-021
8.7.0-172
7.7.0-809
8.0.6-078
8.0.6-119
8.5.2-024
8.8.0-085
8.5.2-027
8.0.7-142
8.5.2-103
8.0.7-149
8.5.2-105
8.0.7-150
8.0.7-151
8.5.3-051
8.0.7-152
8.5.3-064
8.0.8-113
8.0.8-118
8.0.8-401
8.1.0-235
9.0.0-485
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Pre-Upgrade Requirements
7.7.0-500
8.0.0-408
8.1.0-235
8.5.0-389
8.7.0-141
9.0.0-324
7.7.0-608
8.0.0-503
8.1.0-245
8.5.0-390
8.7.0-172
9.0.0-326
7.7.0-706
8.5.0-476
9.0.0-465
7.7.0-710
8.0.5-075
8.5.0-497
8.8.0-021
7.7.0-725
8.0.5-079
8.5.0-518
8.8.0-033
7.7.0-736
8.0.5-082
8.8.0-085
7.7.0-744
7.7.0-753
7.7.0-757
8.5.1-019
8.0.6-053
8.5.1-021
8.0.6-078
8.5.1-022
7.7.0-760
8.0.6-101
7.7.0-761
8.0.6-119
8.5.2-027
7.7.0-764
8.0.6-123
8.5.2-103
8.0.6-124
8.0.6-126
7.7.5-190
7.7.5-194
7.7.5-195
8.0.7-142
7.7.5-302
8.0.7-149
7.7.5-311
8.0.7-150
8.0.8-113
Pre-Upgrade Requirements
Update RAID Controller Firmware
Before upgrading the AsyncOS software, update the RAID controller firmware as described in Cisco
Update for RAID Controller Firmware (For S360/S370/S660/S670 only, reboot required) Release Notes.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Compatibility Details
Configuration Files
Post-Upgrade Reboot
Compatibility Details
Command line and web interfaces. You can access WSA using http://[2001:2:2::8]:8080 or
https://[2001:2:2::8]:8443
Upstream Proxies
Authentication Services
Active Directory (NTLMSSP, Basic, and Kerberos)
LDAP
SaaS SSO
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Transparent User Identification through CDA (communication with CDA is IPv4 only)
Credential Encryption
External DLP Servers (communication between WSA and DLP Server is IPv4 only)
External Authentication
NTP servers
Authentication services
Communication between the Web Security appliance and the Security Management appliance
SNMP
Latest releases of Safari and Firefox browsers on Mac (OSX Version 10.5+)
IE (Version 7+) and latest releases of Firefox and Chrome browsers on Windows 7 and XP.
Kerberos authentication is not available with these operating systems and browsers:
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
Set up your virtual appliance with this AsyncOS release using the documentation described in Deploying
a Virtual Appliance, page 8.
Step 2
Step 3
Step 4
Load the configuration file from the hardware appliance onto the virtual appliance.
If your hardware and virtual appliances have different IP addresses, deselect Load Network Settings
before loading the configuration file.
Step 5
Step 6
Go to Network > Authentication and join the domain again. Otherwise identities wont work.
Configuration Files
When you upgrade AsyncOS for Web from the web interface or Command Line Interface (CLI), the
configuration is saved to file in the /configuration/upgrade directory. You can access the upgrade
directory using an FTP client. Each configuration file name is appended with the version number, and
passwords in the configuration file are masked so they are not human readable.
Generally, configuration files from earlier AsyncOS releases are incompatible with later AsyncOS
releases and vice-versa.
Post-Upgrade Reboot
You must reboot the Web Security appliance after you upgrade AsyncOS for Web.
Changes in Behavior
This section describes changes in behavior from previous versions of AsyncOS for Web that may affect
the appliance configuration after you upgrade to the latest version.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
SNMP Monitoring
Beginning in AsyncOS 8.5, the following functionality is different from previous implementations:
Message authentication and encryption are mandatory when enabling SNMPv3. Passwords for
authentication and encryption should be different. The encryption algorithm can be AES (recommended)
or DES. The authentication algorithm can be SHA-1 (recommended) or MD5.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
10
Previously, the format was LDAP://(groupname). This software change may require changes to policies
or other automation relying on the X-Authenticated-Groups header. [Defect: CSCum91801]
Perform preupgrade requirements, including updating the RAID controller firmware. See
Pre-Upgrade Requirements, page 6.
Log in as Administrator.
Step 1
On the System Administration > Configuration File page, save the XML configuration file off the Web
Security appliance.
Step 2
On the System Administration > System Upgrade page, click Available Upgrades.
The page refreshes with a list of available AsyncOS for Web upgrade versions.
Step 3
Click Begin Upgrade to start the upgrade process. Answer the questions as they appear.
Step 4
When the upgrade is complete, click Reboot Now to reboot the Web Security appliance.
Note
To verify the browser loads the new online help content in the upgraded version of AsyncOS, you must
exit the browser and then open it before viewing the online help. This clears the browser cache of any
outdated content.
New features are typically not enabled by default.
Remove the existing entry for your appliance from the known hosts list in your ssh utility. Then ssh
to the appliance and accept the connection with the new key.
If you use SCP push to transfer logs to a remote server (including Splunk): Clear the old SSH host
key for the appliance from the remote server.
If your deployment includes a Cisco Content Security Management Appliance, see important
instructions in the Release Notes for that appliance.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
11
Documentation Updates
File Analysis: Required Changes to View Analysis Result Details in the Cloud
The requirement in this section was introduced in AsyncOS 8.8.
If you have deployed multiple content security appliances (web, email, and/or management) and you
want to view detailed file analysis results in the cloud for all files uploaded from any appliance in your
organization, you must configure an appliance group on each appliance after upgrading. To configure
appliance groups, see the File Reputation Filtering and File Analysis chapter in the user guide PDF.
(This PDF is more current than the online help in AsyncOS 8.8.)
Upgrading from non-ISE Releases and AsyncOS 8.5 with ISE Preview
All AsyncOS versions that did not include ISE support (that is, all versions prior to 8.5.0-497), and the
limited-availability AsyncOS 8.5 ISE Preview release, did not require the Admin and pxGrid
certificates, which are necessary in all subsequent Cisco AsyncOS releases in order to enable ISE
support. Therefore, when you upgrade from a non-ISE release, or from an ISE Preview installation with
ISE enabled, the ISE feature will not operate correctly until the two additional certificates are provided
(go to Network > Identity Services Engine).
Documentation Updates
The following information supplements information in the Online Help and/or User Guide for this release.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
12
Which Files Can Have their Reputation Evaluated and Be Sent for Analysis?
The criteria for evaluating a files reputation and for sending files for analysis may change at any time.
Criteria are available only to registered Cisco customers. See File Criteria for Advanced Malware
Protection Services for Cisco Content Security Products, available from
http://www.cisco.com/c/en/us/support/security/web-security-appliance/products-user-guide-list.html.
In order to access this document, you must have a Cisco customer account with a support contract. To
register, visit https://tools.cisco.com/RPF/register/register.do.
Additional Information
The User Guide PDF may be more current than the online help. To obtain the User Guide PDF and other
documentation for this product, click the View PDF button in the online help or visit the URL shown in
Related Documentation, page 15.
Known and Fixed Issues in Release 9.0.1-161 (GD - for physical appliances only), page 14
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
13
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1-162&sb=fr&svr=3nH&srtBy=byRel&bt=custV
Known Issues
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1&sb=afr&sts=open&svr=3nH&srtBy=byRel&bt=custV
Known and Fixed Issues in Release 9.0.1-161 (GD - for physical appliances only)
Fixed Issues
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1-161&sb=fr&svr=3nH&srtBy=byRel&bt=custV
Known Issues
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1&sb=afr&sts=open&svr=3nH&srtBy=byRel&bt=custV
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1-135&sb=fr&svr=3nH&srtBy=byRel&bt=custV
Known Issues
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.1&sb=afr&sts=open&svr=3nH&srtBy=byRel&bt=custV
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.0-485&sb=fr&svr=3nH&srtBy=byRel&bt=custV
Known Issues
https://tools.cisco.com/bugsearch/search?kw=*&pf=prdNm&pfVal=282521310&rls
=9.0.0&sb=anfr&sts=open&srtBy=byRel&bt=custV
Go to https://tools.cisco.com/bugsearch/.
Step 2
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
14
Related Documentation
Step 3
Click Select from list > Security > Web Security > Cisco Web Security Appliance, and click OK.
Step 4
In Releases field, enter the version of the release, for example, 8.8.
Step 5
Note
To view the list of resolved issues, select Fixed in these Releases from the Show Bugs drop down.
To view the list of known issues, select Affecting these Releases from the Show Bugs drop down
and select Open from the Status drop down.
If you have questions or problems, click the Help or Feedback links at the top right side of the tool.
There is also an interactive tour; to view it, click the link in the orange bar above the search fields.
Related Documentation
Documentation for this product is available from
http://www.cisco.com/c/en/us/support/security/web-security-appliance/tsd-products-support-series-ho
me.html.
Documentation for Cisco Content Security Management Appliances is available from
http://www.cisco.com/c/en/us/support/security/content-security-management-appliance/tsd-products-s
upport-series-home.html.
Support
Cisco Support Community
Cisco Support Community is an online forum for Cisco customers, partners, and employees. It provides
a place to discuss general web security issues as well as technical information about specific Cisco
products. You can post topics to the forum to ask questions and share information with other Cisco users.
Access the Cisco Support Community for web security and associated management:
https://supportforums.cisco.com/community/5786/web-security
Customer Support
Note
To get support for virtual appliances, call Cisco TAC and have your Virtual License Number (VLN)
number ready.
Cisco TAC: Visit http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html
Support Site for legacy IronPort: Visit http://www.cisco.com/web/services/acquisitions/ironport.html.
For non-critical issues, you can also access customer support from the appliance. For instructions, see
the User Guide or online help.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
15
Support
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of
Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The
use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any
examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only.
Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
2016 Cisco Systems, Inc. All rights reserved.
Release Notes for AsyncOS 9.0.x for Cisco Web Security Appliances
16