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 Add 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.

Step 1: Proxy Details

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

Step 2: 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.

Step 3: Review and Complete Setup

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 Complete setup 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 tabbed panels.

General 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 proxy details to edit the name and description. The edit buttons on this tab and the Proxy Configuration tab require the director-edit permission.

Proxy 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, currently:

Inside this subsection, a Method selector switches between two modes:

MethodBehavior
ManualType the endpoint URL and the access token directly into the form. Populates the target's function_app and function_token properties from these inputs.
Choose proxySelect an existing proxy entry from a dropdown. The platform copies the proxy's URL and token onto the target's function_app and function_token properties at save time, and re-pushes any later changes to the proxy onto every target referencing it.
note

When Choose proxy is selected and no proxies exist for the tenant, the field shows a "No proxy configurations found" 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.