Skip to main content

Proxy

A Proxy is a reusable, named connection profile — a URL paired with an access token — that targets reference by name when they need to send data through an intermediary endpoint. Defining a proxy once and selecting it from a dropdown removes the need to retype the same endpoint and token on every target, and lets the token be rotated in a single place.

note

The Proxy entries managed on this page are not the same thing as the Director Proxy deployment described under VirtualMetric Director Proxy. The deployment-mode Director Proxy is a separate Director instance acting as an Azure-facing forwarder; the entries on this page are platform-managed references to such an endpoint, used by targets to populate function_app and function_token without typing them by hand.

Access​

The Directors page exposes three tabs: Directors, Clusters, and Proxy. Click the Proxy tab to manage proxy entries.

Overview​

The Proxy table displays all configured proxies with the following columns:

ColumnDescription
Proxy nameProxy identifier. Click to open a side drawer summarizing the proxy; its Manage proxy button opens the full detail page.
DescriptionFree text, or - when empty.
Assigned resourcesCount of targets currently referencing this proxy. Click the count to open a popover listing each target with a link to its detail page.

Table Controls:

Above the table, the Search proxies field filters by proxy name. The Refresh icon reloads table data. Click Create new proxy to launch the creation wizard.

At the bottom of the table, pagination controls let you adjust Items per page (10, 20, 30, 40, or 50) and navigate between pages.

Actions Menu:

On the right side of each row, the vertical ellipsis (⋮) opens the row action menu:

  • Manage proxy - Opens the proxy detail page.
  • Clone proxy - Opens the create wizard prefilled from this proxy.
  • Delete proxy - Prompts for confirmation; see Delete.

Create Proxy Wizard​

The proxy creation process guides you through a 3-step wizard: General settings, Proxy configuration, and Review and create.

General Settings​

FieldRequiredDescription
Proxy nameYUnique identifier. Must be 2 to 64 characters.
DescriptionNOptional free-text note.

Proxy Configuration​

FieldRequiredDescription
Proxy URLYThe endpoint URL that consuming targets will forward to.
Access tokenYBearer token presented to the endpoint. Source selected via the Method control: Manual (type the token directly) or Vault (pick an existing secret from the Vault).

Manual entry uses a password input with a show/hide toggle. Vault entry uses a dropdown placeholder "Choose secret from vault" listing every Vault secret available to the tenant.

Review and Create​

The review screen shows two summary blocks — General settings (Proxy name, Description) and Proxy configuration (Proxy URL, Access token). The access token is rendered as ●●●●●● and is never displayed in plain text on this step. Use the Back control on each block to return to the relevant step and edit a value.

Click Create proxy to create the proxy.

Detail View​

Opening a proxy (via Manage proxy from the row action menu or the drawer) shows the detail page with three tabs: Proxy overview, Configuration, and Activity logs.

Proxy Overview Tab​

Displays editable identity fields and read-only timestamps:

  • Proxy name - Proxy identifier.
  • Description - Free text.
  • Proxy information - Read-only block with Created and Last updated timestamps.

Click Manage general settings to edit the name and description. The edit buttons on this tab and the Configuration tab require the director-edit permission.

Configuration Tab​

Displays the URL and access-token configuration:

  • Proxy URL - Endpoint URL.
  • Access token - Manual or Vault source, preserving the selection made in the create wizard.

Click Manage proxy configuration to edit either field. Switching between Manual and Vault on edit is supported.

Activity Logs Tab​

Tracks proxy operations and lifecycle events:

ColumnDescription
UserEmail of user who performed the action.
User IPIP address from which the action was performed.
Object typeAlways Proxy for this view.
ObjectName of the affected proxy.
ActionOperation performed.
Action DescriptionDetailed description.
DateTimestamp of the action.

The toolbar includes a Timeframe filter scoping the entries: Last 24 hours, Last 7 days, Last 30 days, Last 90 days, or All time.

Action Types:

  • CreatedProxy - New proxy created.
  • UpdatedProxy - Proxy configuration modified.
  • DeletedProxy - Proxy removed.

Proxy Operations​

The detail page exposes an actions menu (top right) with the following entries:

Clone​

Select Clone proxy from the row action menu in the table, or from the actions menu on the detail page. The create wizard opens prefilled with the source proxy's URL, token, description, and name (prefixed with Clone ). Edit the Proxy name field as needed before saving.

Delete​

Select Delete proxy from the row action menu or the detail page actions menu (where it appears only for users with the director-delete permission), then confirm in the modal dialog.

warning

A proxy with one or more assigned targets cannot be deleted. The platform displays an error modal titled "Proxy cannot be deleted" with the message "The selected proxy is assigned to multiple resources" and lists each referencing target with a link. Remove the proxy from every listed target, then retry the delete operation. The block is enforced server-side; the same check runs even if the operation is invoked through the API.

Using a Proxy in a Target​

A subset of target types expose a Director proxy subsection in their create wizard, and they do not all expose the same thing.

Four targets get the full subsection, with a Proxy field that takes either a URL or a saved proxy:

ProxyBehavior
ManualType the proxy's URL in the field beside it, and its access token in the Access token field below.
Saved proxySelect a proxy from the list beside it. The platform copies the proxy's URL and token at save time, and pushes later changes to the proxy onto every target that references it.

Azure Monitor Logs has the Director proxy heading with two plain inputs, Proxy URL and Access token, and no list of saved proxies. A stored proxy entry cannot be selected there; enter the values by hand.

Whichever route is used, the platform resolves the choice server-side into the target's function_app and function_token properties before storing it.

note

When Saved proxy is selected and no proxies exist for the tenant, the field shows a "No saved proxies" notification with a Create proxy action button. Create a proxy first, then return to the target wizard.

Because the proxy resolves to the same function_app and function_token target properties documented on each target page, an existing YAML configuration continues to work unchanged — the GUI selector is an alternative way to populate those two fields, not a replacement.