Image URL proxy allowlist
When your users open email messages, Gmail uses Google’s secure proxy servers to serve images that might be included in these messages. This protects your users and domain against image-based security vulnerabilities.
Because of the image proxy, links to images that are dependent on internal IPs and sometimes cookies are broken. The Image URL proxy allowlist setting lets you avoid broken links to images by creating and maintaining an allowlist of internal URLs that'll bypass proxy protection.
When you configure the Image URL proxy allowlist, you can specify a set of domains and a path prefix that can be used to specify large groups of URLs.
Configure the Image URL proxy allowlist setting
- In the Admin console, go to Main menu > Apps > Google Workspace > Gmail > End User Access.
- On the left, select your top-level organization.
- Scroll to the Image URL proxy allowlist section.
- Enter image URL proxy allowlist patterns. Matching URLs will bypass image proxy protection. See the guidelines below for more details and instructions.
- At the bottom, click Save.
Guidelines for applying the Image URL proxy allowlist setting
Security considerations
Consult with your security team before configuring the Image URL proxy allowlist setting. The decision to bypass image proxy allowlist protection can expose your users and domain to security risks if not used with care.
In general, if you have a domain that needs authentication via cookie, and if that domain is controlled by an administrator within your organization and is completely trusted, then allowlisting that URL should not expose your domain to image-based attacks.
Important: Disabling the image proxy is not recommended. This option is available to provide flexibility for administrators, but disabling the image proxy can leave your users vulnerable to malicious attacks.
Entering Image URL patterns
To maintain an allowlist of internal URLs that'll bypass proxy protection, enter the image URL patterns in the Image URL proxy allowlist setting. Matching URLs will bypass the image proxy.
A pattern can contain the scheme, the domain, and a path. The pattern must always have a forward slash (/) present between the domain and path. If the URL pattern specifies a scheme, then the scheme and the domain must fully match. Otherwise, the domain can partially match the URL suffix. For example, the pattern /google.com matches www.google.com, but not gle.com. The URL pattern can specify a path that's matched against the path prefix.
Examples of Image URL pattern
The following patterns are examples only.
The following patterns:
http://rule_fixed_scheme_domain.com/
rule_flex_scheme_domain.com/
rule_fixed_subpath.com/cgi-bin/
... will match the following URLs:
http://rule_fixed_scheme_domain.com/
http://rule_fixed_scheme_domain.com/test.jpg?foo=bar#frag
http://rule_fixed_scheme_domain.com
rule_flex_scheme_domain.com/
t.rule_flex_scheme_domain.com/test.jpg
http://t.rule_flex_scheme_domain.com/test.jpg
https://t.rule_flex_scheme_domain.com/test.jpg
http://rule_fixed_subpath.com/cgi-bin/
http://rule_fixed_subpath.com/cgi-bin/people
Note: The URL scheme (http://) is optional. If the scheme is omitted, the pattern can match any scheme, and allows partial matches on the domain suffix.
Previewing the image URL patterns
Click Preview to see if the URLs match the image URL patterns you've set. If the image URL matches a pattern, you'll see a confirmation message. If the image URL does not match, an error message appears.
Please check the below-supporting article for your further reference:
Set up an image URL proxy allowlist - Google Workspace Admin Help