> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/adapters/configure/service-instance-configuration/properties/proxy-properties/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Proxy properties

> Reference for the adapter proxy object properties that control how the adapter routes requests through a proxy server.

All proxy properties are defined within the `proxy` object in theItential Platform service instance configuration for the adapter.

## Properties

| Property   | Type    | Required         | Description                                                                                      |
| ---------- | ------- | ---------------- | ------------------------------------------------------------------------------------------------ |
| `enabled`  | boolean | Yes              | Determines whether requests to the external system must pass through a proxy.                    |
| `host`     | string  | Yes (if enabled) | Hostname of the proxy server.                                                                    |
| `port`     | integer | Yes (if enabled) | Port of the proxy server.                                                                        |
| `protocol` | enum    | No → `http`      | Protocol to use for the proxy connection. Supported values: `http`, `https`, `socks4`, `socks5`. |
| `username` | string  | No               | Username for proxy authentication.                                                               |
| `password` | string  | No               | Password for proxy authentication.                                                               |

## Example

This example routes requests through a proxy server at `https://myproxy.xyz.com:443` using proxy-specific credentials.

```json
"proxy": {
  "enabled": true,
  "host": "myproxy.xyz.com",
  "port": 443,
  "protocol": "https",
  "username": "Itential",
  "password": "letmein"
}
```

> Reference for the adapter proxy object properties that control how the adapter routes requests through a proxy server.