{ "componentChunkName": "component---src-templates-doc-jsx", "path": "/docs/getting-started/proxy/", "result": {"data":{"markdownRemark":{"html":"

A proxy server acts as a security barrier between your internal network and the Internet, keeping others on the Internet from accessing information on your internal network.

\n

Proxy definition

\n

In basic web speak, a client makes a request to the server, and the server sends back a response.

\n

\"Standard

\n

A proxy server is an application or system that acts as an intermediary between your computer and the internet, or more specifically, the client and server. The proxy makes requests on your behalf to websites, servers, and other internet services.

\n

\"Standard

\n

The proxy can reside on your local machine, somewhere in your network, or at any point between your client and the destination server on the internet.

\n

Similar to the way parents might speak to each other through a child, the child is a proxy relaying all communications between the 2 parents.

\n
\n

Parent 1: Ask your father if he can pick you up after school.

\n
\n

Timmy: Can you pick me up after school.

\n
\n

Parent 2: Yeah.

\n
\n

Timmy: Dad says yeah.

\n
\n
\n
\n
\n

In this analogy, the child forwards the information on behalf of each parent. Besides just relaying information, proxies can do much more.

\n\n

A proxy acts like a go-between to perform various functions. Postman has a built-in web proxy to capture API requests, the Postman Interceptor to intercept network traffic, and proxy settings to direct API requests.

\n

Configuring proxy settings

\n

This article describes how to configure the proxy settings in Postman to direct all requests made in Postman to route through a proxy server. This is different from capturing network traffic with the built-in proxy which enables Postman to intercept network traffic.

\n

Postman's native apps for Mac, Windows, and Linux support configuring proxies. You can either specify to use a custom proxy or to use the system proxy defined in the operating system.

\n

Use the custom proxy if all of your applications need to use the same proxy. Turn custom proxy on if you want to direct the requests from Postman go through a custom proxy server. Turning it off will direct the requests to not use the proxy server.

\n

To configure the proxy settings, select the gear icon on the right side of the header toolbar, choose Settings, and select the Proxy tab.

\n

\"Proxy

\n

Using a custom proxy

\n

Postman enables you to configure Custom Proxy Configuration that direct Postman to forward your HTTP or HTTPS requests through a proxy server. This will route all requests sent by Postman through a proxy server of your choosing.

\n
    \n
  1. Postman is the client that sends a request through the selected proxy.
    2. \n
  2. The proxy server sends the request to the server.
    3. \n
  3. The server returns a response back through the proxy server.
    4. \n
\n

\"Enable

\n

Custom proxy settings are turned off by default and can be turned on using the toggle switch.

\n

Choose the type of proxy server by checking the appropriate checkboxes beside Proxy Type. By default, both HTTP and HTTPS are checked. This means that both HTTP and HTTPS requests will go through the proxy server.

\n

The first field under Proxy Type is Proxy Server. Here, enter the host or IP address (without protocol) of the proxy server. The next field to Proxy Server is where the port of the proxy server is provided.

\n

The field below Proxy Server is Proxy Auth. Postman uses the system's proxy configurations by default. To send API requests, select the option This proxy requires authentication. Turning this on makes the requests use Basic Authentication method, which requires a username and a password.

\n\"Default\n

The Proxy Bypass setting is below the Proxy Server option. A number of comma-separated hosts can be provided here for which the requests don't use the proxy settings.

\n

\"Custom

\n

Using a system proxy

\n

The Use the system proxy option enables Postman to use the system's default proxy configuration. It contains an option to use HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables.

\n

If all of your applications need to use the same proxy, you might need to use a default proxy configured at the Operating System level. Use the system proxy settings to forward your HTTP or HTTPS requests in Postman through your OS’s default configuration. In other words, you are telling the Postman and all requests sent using Postman to follow your OS's default configuration.

\n
    \n
  1. Postman is the client that sends a request through your Operating System’s default configuration, which forwards the request to the proxy server.
    2. \n
  2. The system proxy server sends the request to the server.
    3. \n
  3. The server returns a response back through the proxy server.
    4. \n
\n

\"System

\n

System proxy settings are enabled by default. Any request made through Postman will go through the system proxy.

\n

You can select the option \"Use the system proxy\" to turn the system proxy on or off. When it's unchecked, all the requests are made directly. However, regardless of the proxy setting in the app, Postman will still use the system proxy if there is an environment variable set.

\n

\"Use

\n

Note: If the Use System Proxy and the Custom Proxy Configuration are both turned on, then the Custom Proxy Configuration will take precedence.

\n

Troubleshooting proxy configurations

\n

If you are unable to send any requests through Postman and your network requires a proxy, take the following steps:

\n\n

If you are unable to send any requests through Postman and your network doesn't require a proxy, take the following steps:

\n\n

If your proxy has basic auth, take the following steps:

\n\n

For troubleshooting configuration or request issues, see Troubleshooting using console.

","frontmatter":{"title":"Using a custom proxy","contextual_links":[{"type":"section","name":"Prerequisites","url":null,"blog_tag":null},{"type":"link","name":"Setting up Postman","url":"/docs/getting-started/settings/","blog_tag":null},{"type":"section","name":"Additional Resources","url":null,"blog_tag":null},{"type":"subtitle","name":"Related Blog Posts","url":null,"blog_tag":null},{"type":"link","name":"Client proxy settings in Postman","url":"https://blog.postman.com/client-proxy-settings-in-postman/","blog_tag":null},{"type":"link","name":"Capture Responses Using the Postman Proxy","url":"https://blog.postman.com/capture-responses-using-the-postman-proxy/","blog_tag":null}]},"fields":{"slug":"/docs/getting-started/proxy/","lastModifiedDate":"2022/03/14\n"}}},"pageContext":{"slug":"/docs/getting-started/proxy/"}}, "staticQueryHashes": ["3840739351","63159454"]}