---
title: "Proxy Endpoints"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints
language: matlab
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Proxy Endpoints

Programming language: MATLAB. Other languages: [C++](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/java.md), [JavaScript](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/js.md), [PHP](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/php.md), [Python](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints/swift.md).

A direct proxy holds one or more endpoints, which tell Ice how to reach the target object. An indirect proxy holds no endpoint: Ice obtains the endpoints from a [locator](https://docs.zeroc.com/ice/3.8/runtime/locators.md).

## Direct Proxies

The endpoints of a direct proxy are usually the [published endpoints](https://docs.zeroc.com/ice/3.8/runtime/dispatch/object-adapter-endpoints.md#published-object-adapter-endpoints) of the object adapter that hosts the target object. For example, the target object of this proxy is reachable over TCP on host `frosty.zeroc.com` and port `4061`:

```text
greeter:tcp -h frosty.zeroc.com -p 4061
```

A proxy can hold several endpoints, separated by colons (`:`):

```text
greeter:tcp -h venus -p 4061:tcp -h mars -p 4061:tcp -h saturn -p 4061
```

These endpoints are typically the addresses of the [replicas](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxies-to-replicated-objects.md) of the target object. Ice selects which endpoint to connect to according to the proxy's [endpoint selection](https://docs.zeroc.com/ice/3.8/property-reference/proxy-properties/matlab.md#name.endpointselection) type.

### Endpoints with Different Transports

Ice accepts a proxy whose endpoints use different transports, and uses only the endpoints that suit the proxy's [invocation mode](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode.md). Such proxies are discouraged: do not combine `udp` endpoints with endpoints of other transports, or secure endpoints with non-secure ones such as `ssl` with `tcp`. The object adapter that hosts the target object should listen on secure endpoints or on non-secure endpoints, not both; see [Endpoint Security Considerations](https://docs.zeroc.com/ice/3.8/runtime/ssl-transport/matlab.md#endpoint-security-considerations).

## Indirect Proxies

An indirect proxy is a proxy with an adapter ID or a well-known proxy. When an invocation on an indirect proxy needs a connection, Ice asks the locator for the endpoints, and caches the reply as described in [Locator Semantics for Clients](https://docs.zeroc.com/ice/3.8/runtime/locators/locator-semantics-for-clients/matlab.md).

### Proxy with an Adapter ID

A proxy with an adapter ID refers to an object hosted by the object adapter with this adapter ID, or by the object adapters of the replica group with this ID:

```text
greeter @ GreeterAdapter
```

### Well-Known Proxy

A well-known proxy holds only an identity, without endpoints or an adapter ID:

```text
greeter
```

## See Also

- [Terminology](https://docs.zeroc.com/ice/3.8/basics/terminology.md)
- [Syntax for Stringified Proxies](https://docs.zeroc.com/ice/3.8/runtime/invocation/syntax-for-stringified-proxies.md)
- [Object Adapter Endpoints](https://docs.zeroc.com/ice/3.8/runtime/dispatch/object-adapter-endpoints.md)
- [Locators](https://docs.zeroc.com/ice/3.8/runtime/locators.md)
