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:
| Field | Description | Example |
|---|---|---|
| Generated By | Email address of the user who generated the link. | john.michel@gmail.com |
| Status | Current state of the link. See Section 4 for status definitions. | Active / Expired / Revoked |
| Expiry Date | Date and time the link is set to expire. Displays a dash ( – ) if no expiry is set. | May 7, 2026, 1:00 AM |
| Created Date | Date and time the link was originally created. | Jan 1, 5:19 AM |
| App Name | The 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.
Link Status Reference¶
Each secured link carries one of the following statuses, displayed as a colour-coded badge on the card:
| Status | Colour | Description |
|---|---|---|
| Active | Green | The link is valid and accessible. Recipients can use this link. |
| Expired | Orange/Grey | The link has passed its expiry date and is no longer accessible. The link can be reactivated if required. |
| Revoked | Red | The 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.
| Icon | Action | Description |
|---|---|---|
| ⧉ | Copy Link | Copies the secured link URL to the clipboard. A preview of the link is also displayed in the link URL window for reference. |
| ✓ | Activate | Re-enables a Revoked or Expired link, restoring access for recipients. This action is only available when the link is not currently Active. |
| ✕ | Revoke | Immediately 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 Date | Opens 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. |
| 🗑 | Delete | Permanently 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.