This document describes the steps to configure the Upstream Proxy in the Secure Web Appliance (SWA).
Cisco recommends that you have knowledge of these topics:
Cisco recommends that you have these tools installed:
This document is not restricted to specific software and hardware versions.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
Use these steps to configure an Upstream Proxy in SWA:
| Steps |
Steps |
| Step 1. (Optional) Create a Custom URL Category for URLs |
Step 1.1. From the GUI, choose Web Security Manager, and click Custom and External URL Categories. Step 1.5. From List Order, choose the first category to position on top. Step 1.6. From Category Type drop-down list, choose Local Custom Category. Step 1.7. Add desired URLs in the Sites section. Step 1.8. Submit.
|
Step 2. (Optional) Create an Identification Profile to Use for the Upstream Proxy |
Step 2.1. From the GUI, choose Web Security Manager, and click Identification Profiles. Step 2.7. If you do not want to authenticate the users hitting this policy, in the User Identification Method section, choose Exempt from authentication/identification, else configure the authentication parameters. Step 2.8. In the Define Members by Subnet, leave this field blank to include all Client IP addresses, unless you want to Pass Through traffic for a certain IPs. Step 2.9. (Optional: If you need to use an upstream proxy for specific users accessing certain websites, complete this step). From the Advanced section, choose Custom URL Categories, and Add the Custom URL Category that was created in Step 1. Step 2.10. Submit.
|
Step 3. Create the Upstream Proxy |
Step 3.1. From the GUI, choose Network, and click Upstream Proxy. Step 3.2. Click Add Group. Step 3.3. Assign a unique Name. Step 3.6. (Optional) If you entered more than one Upstream Proxy from the Load Balancing section, define the desired Load Balancing method,
Step 3.7. Choose the Failure Handling option that matches your internal policy.
Step 3.8. Submit.
|
Step 4. (Optional) Upload the Decryption Certificate |
Step 4.1. From the GUI, choose Network, and click Certificate Management. Step 4.2. From the Certificate Management section, click Manage Trusted Root Certificates.
Step 4.3. Submit and Commit changes. |
Step 5. Configure the Routing Policy |
Step 5.1. From GUI, Choose Web Security Manager and then click Routing Policy. Step 5.2. (Optional) If you would like to use the upstream proxy for specific users or websites, click Add Policy, and choose the Identification Profile that you created on Step 2.
Step 5.3. For the required settings you prefer in the upstream proxy, click on the Routing Destination link and select the Upstream Proxy Group you created in Step 3.
Step 5.4. Submit and Commit the changes. |
Step 6. (Optional) Configuring the Upstream Proxy Unresponsive Timeout Settings |
Step 6.1. Log in to the CLI and run advancedproxyconfig. Step 6.2. Select MISCELLANEOUS. Step 6.3. Press Enter until you see Enter minimum idle timeout for checking unresponsive upstream proxy (in seconds). You can configure the minimum amount of time, SWA waits to retry the upstream proxy that was previously declared Sick. The default value is 10 seconds. Step 6.4. Press Enter to proceed to the next setting. When defining the maximum idle timeout for checking an unresponsive upstream proxy, note if this timeout value is reached before the configured number of reconnection attempts is exhausted (Step 3), the SWA considers the upstream proxy offline. Step 6.5. Keep pressing Enter, until you exit the wizard, run commit to save the changes. |
In the Accesslogs, traffic routed to the upstream proxy is shown as DEFAULT_PARENT trailed by the name of the upstream proxy. This is an example:
1775659642.780 462 10.20.3.15 TCP_MISS_SSL/200 129 CONNECT tunnel://www.cisco.com:443/ "AMOJARRA\amojarra" DEFAULT_PARENT/10.48.48.182 - DECRYPT_WEBCAT_7-DPurl-Auith-NONE-NONE-NONE-DefaultGroup-NONE <"IW_comp",8.7,1,"-",-,-,-,-,"-",-,-,-,"-",-,-,"-","-",-,-,"IW_comp",-,"-","Computers and Internet","-","Unknown","Unknown","-","-",2.23,0,-,"-","-",-,"-",-,-,"-","-",-,-,"-",-,-> - -
From the Proxylogs, you can verify the health status of the upstream proxies.
These are some examples of what was configured with the Reconnecting Attempts in Step 3 to two times. After the second failure connecting to the upstream proxy, the upstream proxy is declared dead and SWA removes this upstream proxy from the list until the proxy process is restarted:
Thu Apr 2 13:52:35 2026 Info: PROX_CONNTRACK : 940 : [15968:0] Peer-upstream 10.48.48.182:3128 was healthy, now sick.
Thu Apr 2 13:52:36 2026 Info: PROX_CONNTRACK : 940 : [15968:0] Peer 10.48.48.182:3128 was sick, now healthy.
...
Thu Apr 2 13:59:37 2026 Info: PROX_CONNTRACK : 60 : [71197:0] Peer 10.48.48.183:3128 remains sick after 2 failures.
Thu Apr 2 13:59:39 2026 Warning: PROX_CONNTRACK : 70 : [71197:0] Peer-upstream 10.48.48.183:3128 declared dead.
| Revision | Publish Date | Comments |
|---|---|---|
2.0 |
21-Oct-2026
|
Updated Introduction, spelling, grammar, spacing, inserted horizontal lines to separate sections for readability, fixed CCW alerts. |
1.0 |
28-Apr-2026
|
Initial Release |