Proxies

Proxies allow Team Owners and Team Admins (with access to Orchestrate) to securely route HTTP requests to external services through SuperAnnotate. Instead of exposing credentials directly in the platform, you can configure a proxy with an approved target domain and the required HTTP headers, ensuring requests are forwarded securely and only to authorized external destinations.

Create a proxy

Before creating a proxy, be sure that you’ve got at least one Secret available in your team.

To create a proxy:

1. From Team Setup, go to Proxies under the Security tab.
2. Click on + Create.
3. Type the name of your proxy.
4. Type the description of your proxy (optional).
5. Enter the destination URL under Target Domain where all requests will be forwarded.
6. Under Headers, select a secret to configure the HTTP headers that’ll get injected into every request that gets routed through this proxy. These are the Secret-defined headers.
7. Under Additional headers, you may add headers using key-value pair forms or JSON snippets.
8. Under Final headers preview, you can see your configured headers in a finalized set that’ll get sent with each request.
9. Once you’re done, click Create.

📘

About additional headers

• If a header in this section has the same key name as a key in the selected Secret, this value will take precedence.
• Defining additional headers this way allows you to manage authentication details centrally while still supporting per-proxy customization.

🚧

Target domain limitations

When entering a target domain, please keep in mind that the following domains aren’t allowed:

• localhost, 127.0.0.1, ::1, 0.0.0.0
• AWS IPs 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16
• SuperAnnotate-related domains.

Edit a proxy

To edit a proxy:

1. From Team Setup, go to Proxies under the Security tab.
2. Find the proxy you want to edit.
3. Click on the three dots ⋮, and then click Edit.
4. Make your changes as needed.
5. Click Save.

Duplicate a proxy

To duplicate a proxy:

1. From Team Setup, go to Proxies under the Security tab.
2. Find the proxy you want to duplicate.
3. Click on the three dots ⋮, and then click Duplicate.
4. In the pop-up, type a new unique name for the duplicate proxy.
5. Click Duplicate.

Delete a proxy

To delete a proxy:

1. From Team Setup, go to Proxies under the Security tab.
2. Find the proxy you want to delete.
3. Click on the three dots ⋮, and then click Delete.
4. In the pop-up, click Delete.

🚧

Proxy in use

If a used proxy is deleted, all projects using it will be affected and may become invalid.

📘

Keep in mind

You can only have up to 200 proxies per team.