Change a web proxy's settings

The Switches card on a web proxy's Overview tab turns the web application firewall, Force HTTPS, WebSockets and development mode on or off. The Settings tab shows the web proxy's name and number, checks how the name resolves when Coritan hosts its DNS zone, and deletes the web proxy.

• The web proxy's name is not under a domain on your Domain Management list. A web proxy that is, opens on that website, where the switches are on the Security, SSL/TLS, Origin and Caching tabs (Manage a website's origin, Protect a website with the WAF). A web proxy that a proxied DNS record created in one of your zones is a hostname of its website, and you delete it by turning Proxied off for the record (Web proxies and DNS records).
• You find the web proxy in the Web proxies tab of Game Shield.

1. In the dashboard, go to Game Shield and select the web proxy in the Web proxies tab. Its Overview tab opens.
2. On the Switches card, turn the switch on or off. It saves at once.

Web application firewall

Checks each request against the managed rule set before it reaches the origin (The web application firewall). With it off, every request that passes the other steps reaches the origin unchecked.

Force HTTPS

Redirects plain HTTP requests to the same address over HTTPS with a 301. Certificate validation over HTTP still works while it is on.

WebSockets

Passes WebSocket connections through to the origin. With it off, a visitor's WebSocket connection fails.

Development mode

Adds diagnostics to the edge's error pages for a time you choose (Use development mode while you debug).

When the edge cannot reach the origin, its error page shows a ray ID, the edge, the time and the name of the failure, such as Connection refused. Development mode adds what you need to find the cause:

• The web proxy's number, the failure's reason code and how many origins the edge tried.
• A table of each origin the edge tried, with its address, the protocol, the result and how long the attempt took.
• The full diagnostics, even when your error page is set to show less (Customise the error page).
• On every answer that succeeds, a Coritan-Origin header with the address of the origin that answered, next to Coritan-Ray and Coritan-Edge.

1. On the Switches card, choose how long it stays on under Turn off after: 1 hour, 3 hours, 12 hours, 24 hours or Until you turn it off. It starts at 3 hours.
2. Turn on Development mode.

The switch then shows the time left and when it ends, such as On for 2 more hours, or On until you turn it off. When the time runs out, the edge stops showing the diagnostics and the switch shows Expired. To turn development mode on again, or to change its time, turn it off, choose a new time and turn it on again.

When Coritan hosts the DNS zone for the name, the Settings tab has a DNS card. It lists the name's A, AAAA and CNAME records and says where visitors go:

Traffic goes through our network

At least one A or AAAA record for the name is proxied, so resolvers get our network's addresses for both A and AAAA queries. A DNS only address record at the name shows Not published while the name is proxied, because its address is not given out (Proxied records).

Visitors reach the origin directly

No address record for the name is proxied. Visitors who get its address skip Coritan's network, the certificate and the WAF. Turn Proxied on for the record (Edit a record).

Nothing points here yet

The zone has no A, AAAA or CNAME record for the name. Add a proxied A record with the origin's address (Add, edit and delete DNS records).

A CNAME record shows Follows the target: visitors go wherever its target resolves. Open zone opens the zone's DNS tab. When another provider hosts the zone, the card does not appear, and you check the name's records there.

1. On the web proxy's Settings tab, find the Delete this web proxy card and select Delete web proxy….
2. Type the web proxy's name, such as www.example.com, to confirm.
3. Select Delete web proxy.

Deleting leaves the name's DNS records as they are. A proxied record keeps sending visitors to Coritan's network, which answers 404 for the name. Turn Proxied off for the record to send visitors straight to your server. The certificate stays on your account, and a new web proxy for the name uses it.

You cannot change a web proxy's name, because its certificate, WAF and DNS answer belong to the name. To serve a different name, create a web proxy for it (Create a web proxy), then delete this one.

• Each switch confirms its change, such as WAF updated., Force HTTPS updated., WebSockets updated. or Development mode updated. The edge applies it within a few seconds.
• Deleting shows Web proxy for www.example.com deleted. and returns to the list of web proxies.

The WAF blocks requests your site needs

You cannot change the WAF's rules or exempt a path. Turn the Web application firewall off for this web proxy, or serve the traffic that the WAF blocks, such as an API, from a name with a web proxy of its own and the WAF off.

The switch shows Expired

Development mode ran out, and the edge no longer shows the diagnostics. Turn the switch off, choose a new time under Turn off after and turn it on again.

The name answers 404 after you delete its web proxy

The name's record is proxied, so visitors still reach the edge, and the name has no web proxy. Create a web proxy for the name, or turn Proxied off for the record and on again, which gives the name a web proxy to the record's address.

• How web proxies work
• Change a web proxy's origin
• Customise the error page
• Troubleshoot proxies and join addresses

The switches are fields of PATCH /api/v1/proxy/routes/{route_id}: waf_enabled, force_https, websocket_enabled and development_mode (Change a web proxy's origin). This call turns development mode on for an hour:

curl -X PATCH https://api.coritan.com/api/v1/proxy/routes/31 \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"development_mode": true, "development_mode_minutes": 60}'

{"message": "Route updated"}

development_mode_minutes runs from 0 to 1440. 0 keeps development mode on until you turn it off, and leaving the field out gives 180 minutes. Send {"development_mode": false} to turn it off. GET /api/v1/proxy/routes/{route_id} returns the state the edge reads: development_mode_active, development_mode_expires_at in UTC, and development_mode_seconds_left, which is null when development mode has no end.

Delete a web proxy with DELETE /api/v1/proxy/routes/{route_id}:

curl -X DELETE https://api.coritan.com/api/v1/proxy/routes/31 \
  -H "Authorization: Bearer $CORITAN_TOKEN"

{"message": "Route deleted"}

The call deletes the web proxy with its redirect rules at once, and asks for no confirmation. A web proxy that is not on your account answers 404 with Route not found.