Configuring the Allowlist

Confluence administrators can choose to allow incoming and outgoing connections and content from specified sources for use in the:

by adding URLs to the allowlist. 

Confluence will display an error if content has been added that is not from an allowed source, and prompt the user to add the URL to the allowlist.

Application links are automatically added to the allowlist. You don't need to manually add them. 

Add allowed URLs to the allowlist

To add a URL to the allowlist:

  1. Go to  > General Configuration > Allowlist
  2. Enter the URL or expression you want to allow.
  3. Choose the Type of expression (see below for examples of the types available).
  4. Choose Allow Incoming if you need to allow CORS requests (see below).
  5. Choose Add

Your URL or expression appears in the allowlist.

To test that your allowlisted URL is working as expected you can enter a URL in the Test a URL field. Icons will indicate whether incoming and / or outgoing traffic is allowed for that URL. 

Expression Types

When adding a URL to the allowlist, you can choose from a number of expression types. 

TypeDescriptionExample
Domain nameAllows all URLs from the specified domain.https://www.example.com
Exact matchAllows only the specified URL.https://www.example.com/thispage
Wildcard ExpressionAllows all matching URLs. Use the wildcard * character to replace one or more characters.https://*example.com
Regular ExpressionAllows all URLs matching the regular expression.http(s)?://www\.example\.com

Allow Incoming

Allow Incoming enables CORS requests from the specified origin. The URL must match the format scheme://host[:port], with no trailing slashes (:port is optional). So http://example.com/ would not allow CORS requests from the domain example.com.

Disabling the allowlist

The allowlist is enabled by default. You can choose to disable the allowlist however this will allow all URLs, including malicious content.

We strongly discourage you from disabling the allowlist, as it will leave you vulnerable to Server-Side Request Forgery (SSRF) attacks, such as the one disclosed in CONFSERVER-61399 - Getting issue details... STATUS

To disable the allowlist:

  1. Go to  > General Configuration > Allowlist.
  2. Choose Turn off allowlist.
  3. Choose Confirm

All URLs will now be allowed. We strongly recommend not disabling the allowlist. 

Last modified on Jul 15, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.