Skip to content

Secured Links

The Secured Links panel is a dedicated administration interface for managing all secure links generated within the Portal Studio platform. It provides administrators with a centralised view of link status, metadata, and link parameters, along with a full set of management actions.

This panel is designed to replace manual link tracking and gives administrators real-time visibility and control over the lifecycle of every secured link.

Key capabilities include:

  • Viewing all secured links in an expandable card layout
  • Filtering links by status, link parameters, and generated-by email (in progress)
  • Performing actions: copy, activate/revoke, set expiry, and delete
  • Inspecting dynamic link parameters associated with each link

Accessing the Panel

The Secured Links panel is accessible from the main navigation within Portal Studio.

  • Navigate to:Admin Configuration > Secured Links

Card View Layout

Secured links are displayed in a card-based layout. Each card represents a single secured link. The card view was chosen over a standard grid layout because link parameters are dynamic, with keys and values varying between links, making a fixed column structure unsuitable.

Collapsed Card View

By default, cards are displayed in a collapsed state showing the most important fields at a glance:

FieldDescriptionExample
Generated ByEmail address of the user who generated the link.john.michel@gmail.com
StatusCurrent state of the link. See Section 4 for status definitions.Active / Expired / Revoked
Expiry DateDate and time the link is set to expire. Displays a dash ( – ) if no expiry is set.May 7, 2026, 1:00 AM
Created DateDate and time the link was originally created.Jan 1, 5:19 AM
App NameThe application associated with the secured link.secured app

Expanded Card View

Clicking a card expands it to reveal additional detail, including the Link Parameters section. Link parameters are dynamic key-value pairs unique to each link — for example, contactSeq: foobar or params: super secret msg.

Cards can be individually expanded or collapsed as needed.

Each secured link carries one of the following statuses, displayed as a colour-coded badge on the card:

StatusColourDescription
ActiveGreenThe link is valid and accessible. Recipients can use this link.
ExpiredOrange/GreyThe link has passed its expiry date and is no longer accessible. The link can be reactivated if required.
RevokedRedThe link has been manually revoked by an administrator. Access is disabled. The link can be reactivated using the Activate action.

Each card includes an Actions row with icon-based controls. Available actions may vary depending on the current status of the link.

Note: The Activate and Revoke actions are mutually exclusive. Only one will be visible at a time depending on the current link status.

IconActionDescription
⧉Copy LinkCopies the secured link URL to the clipboard. A preview of the link is also displayed in the link URL window for reference.
✓ActivateRe-enables a Revoked or Expired link, restoring access for recipients. This action is only available when the link is not currently Active.
✕RevokeImmediately disables an Active link, preventing further access. The link record is retained and can be reactivated. This action is only available when the link is Active.
⏱Set Expiry DateOpens a date/time picker to define or update the expiry date for the link. Once the expiry date is reached, the link status changes to Expired automatically.
🗑DeletePermanently removes the secured link record. This action cannot be undone. Use with caution.

Filtering Secured Links

The filter toolbar at the top right of the panel allows administrators to narrow down the list of displayed links. Two filter types are currently available, with a third in development.

Filter by Status

  • Use the Status filter to display only links matching a specific state: Active, Expired, or Revoked. This is useful when performing bulk reviews or audits of links in a particular state.

Filter by Link Parameters

Link parameters are dynamic key-value pairs attached to a secured link at the time of generation. They are used to pass contextual information to the destination application — for example, a contact reference, session token, or custom identifier.

Because the keys and values are different for every link, link parameters are displayed in the expanded card view rather than as fixed table columns. A dash ( — ) is shown when a link has no associated parameters.

Example link parameters:

  • contactSeq = foobar
  • params = super secret msg
  • test = pravTest

To filter by a parameter:

  • Enter the key and value as a pair in the format: key=value
  • Multiple key-value pairs can be combined using a delimiter (comma or semicolon).
  • Example: contactSeq=foobar,params=super secret msg

Note: Link parameter filtering is case-sensitive. Ensure the key and value match exactly as stored against the link.

Filter by multiple link parameters at once:

  • Enter multiple key=value pairs separated by a comma or semicolon in the link parameter filter field. For example: contactSeq=foobar,params=testvalue

Key Considerations

  • Deletion permanently removes the link record from the system. If a link needs to be disabled temporarily, use Revoke instead of Delete.
  • Once the expiry date and time is reached, the link status automatically changes to Expired and the link becomes inaccessible to recipients. The record is retained in the panel and can be reactivated or deleted by an administrator.
  • The Revoke action is only available for Active links. If a link is already Expired or Revoked, the Activate button will be shown instead.
  • App name filtering is not currently available but has been identified as a future enhancement.