- Installing and updating
- Navigating Postman
- Sending your first request
- Managing your account
- Syncing your work
- Discovering templates
- Creating your first collection
- Creating a workspace
- Setting up your Postman app
- Importing and exporting data
- Troubleshooting app issues
- Building requests
- Authorizing requests
- Receiving responses
- Grouping requests in collections
- Using variables
- Managing environments
- Visualizing responses
- Specifying examples
- Using cookies
- Working with certificates
- Generating client code
- Troubleshooting requests
- Scripting in Postman
- Writing pre-request scripts
- Writing tests
- Using the Collection Runner
- Scheduling runs with monitors
- Building request workflows
- Importing data files
- Working with your team
- Defining roles
- Requesting access
- Sharing your work
- Your private API network
- Commenting on collections
- Versioning APIs
- Using version control
- Using the API Builder
- Managing and sharing APIs
- Validating APIs
- Monitoring APIs
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Running Postman monitors using static IPs
- Troubleshooting monitors
- Monitoring FAQs
- Analyzing with reports
- Documenting your API
- Authoring your docs
- Publishing your docs
- Viewing documentation
- Using custom domains
- Publishing templates
- Publishing to the API Network
- Submission guidelines
- Managing your team
- Purchasing Postman
- Configuring team settings
- Utilizing audit logs
- Onboarding checklist
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Microsoft AD FS
- Custom SAML in Azure AD
- Custom SAML in Duo
- Custom SAML in GSuite
- Custom SAML in Okta
- Custom SAML in Onelogin
- Custom SAML in Ping Identity
- Migrating to the current version of Postman
- Developing with Postman utilities
- Postman API
- Echo API
- Collection SDK
- Postman Runtime library
- Code generator library
- Postman Collection conversion
Using a proxy
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.
In basic web speak, a client makes a request to the server, and the server sends back a response.
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.
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.
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.
Parent 1: Ask your father if he can pick you up after school.
Timmy: Can you pick me up after school.
Parent 2: Yeah.
Timmy: Dad says yeah.
In this analogy, the child forwards the information on behalf of each parent. Besides just relaying information, proxies can do much more.
- Record all traffic between your machine and the internet
- Reveal the contents of all requests, responses, cookies, and headers
- Route traffic to specified internet locations
- Security from direct attacks
- DevOps load balancing
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.
This article describes how to configure the proxy settings in Postman to direct all requests made in the Postman app to route through a proxy server. This is different from capturing network traffic with the built-in proxy which allows Postman to intercept network traffic.
Postman's native apps for Mac, Windows, and Linux support configuring proxies. You can either specify to use a custom Global proxy or to use the system proxy defined in the operating system.
Use the Global proxy if all of your applications need to use the same proxy. Turn Global 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.
To configure the proxy settings, click the wrench icon on the right side of the header toolbar, choose “Settings”, and select the Proxy tab.
Postman allows you to configure Global Proxy Configuration that direct Postman to forward your HTTP or HTTPS requests through a proxy server. In other words, this will route all requests sent via the Postman app through a proxy server of your choosing.
- The Postman app is the client that sends a request through the selected proxy.
- The proxy server sends the request to the server.
- The server returns a response back through the proxy server.
Global proxy settings are disabled by default and can be turned on using the toggle switch.
Choose the type of proxy server by checking the appropriate checkboxes beside Proxy Type. By default, both
HTTPS are checked. This means that both HTTP and HTTPS requests will go through the proxy server.
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.
The Field below Proxy Server is Proxy Auth, turning this on makes the requests use Basic Authentication method, which requires a username and a password.
The Proxy Bypass setting lies below the Proxy Server option. A number of comma separated hosts can be provided here for which the requests do not use the proxy settings.
The Use System Proxy option allows Postman to use the system's default proxy configuration. It contains an
option to use
NO_PROXY environment variables of the said system.
If all of your applications need to use the same proxy, you might have 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 app and all requests sent using Postman to follow your OS's default configuration.
- The Postman app is the client that sends a request through your Operating System’s default configuration, which forwards the request to the proxy server.
- The system proxy server sends the request to the server.
- The server returns a response back through the proxy server.
System proxy settings are enabled by default. Any request made through Postman will go through the system proxy.
You can turn this setting on and off using the toggle switch. When turned off, 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.
Note: If the Use System Proxy and the Global Proxy Configuration are both turned on, then the Global Proxy Configuration will take precedence.