Skip to main content

Release Notes

2.2.0#

This release introduces new server role management, improved onboarding validation flows, and expanded audit access capabilities. It also delivers a range of usability and interface improvements including responsive search, scroll-to-error behaviour, and updated design components, alongside fixes addressing search feedback, metadata schema handling, and permission consistency.

New features#

Directory Version Display

The current directory version is now displayed in the UI via the profile menu. Clicking "Versions" opens a modal showing the active release version, with direct links to the Release Notes and API Documentation for quick reference.

Server Roles

Authorisation Servers now include a dedicated Roles tab, mirroring the existing Application Roles experience. The tab displays relevant information about associated domains, roles, and authorities, and allows administrators to add and manage server roles directly from the server detail view.

Improved OTP Validation in Onboarding

The onboarding verification flow has been updated to separate email and phone OTP validation into distinct steps and screens. Email is now validated first, followed by phone where applicable. If phone OTP is not configured in the environment, it is no longer required during registration and is not shown in the UI. Validation messaging dynamically reflects which channels were used.

New Scope for Audit Log Access Across Organisations

A new `directory:software:audit` scope has been introduced to support automated retrieval of audit logs via client credentials, without relying on a human user account. Organisation Administrators can now use an Application with a role containing this scope to query the `GET /audit` endpoint and access audit log data from other participants in the ecosystem.

Enhancements#

Disabled Action Icon in Cards When Unavailable

The action icon on Organisation, Server, and Application cards is now visually disabled when the action is not available to the current user. A tooltip is displayed to clarify the reason: inactive items show "Actions cannot be performed on this item" and users without the necessary permissions see "Only users with the correct permission can interact with this item."

Updated Toggle Design

Toggle controls across the Directory have been updated to align with the design system, delivering a refreshed and more consistent visual appearance.

Responsive Search Bar

The search bar now adapts its size responsively across screen sizes. On mobile, it is scaled to fit smaller screens while remaining usable. On laptop and ultra-wide displays, it scales dynamically to fit its container, whether or not additional controls are present alongside it.

Paginated Certification Types Dropdown

The Certification Type and Certification Type Variant dropdowns on the New Certification dialog for Servers and Applications now support auto-complete and pagination, improving performance and usability when working with large numbers of certification types.

Scroll to Error Behaviour

Forms within dialogs now automatically scroll to the first error field when the user advances to the next step and validation fails. The page scrolls smoothly to the relevant field, inline errors are clearly visible, and the error summary remains at the top of the dialog for context.

Bug fixes#

Improved Global Search Feedback

Fixed an issue where opening the global search bar and typing immediately would briefly display a "No results for..." message before the search had completed. The interface now correctly shows a "Searching..." state while a query is in progress, and the no-results message is only shown once a completed search returns no matches.

API Metadata Schema Duplication Across API Families

Fixed an issue where configuring API Resource Metadata at the authorisation server level would incorrectly apply the same schema to multiple distinct API Families until the page was refreshed. Each API Family now correctly reflects its own configured metadata schema without requiring a page reload.

API Resources Metadata Permission Fix

Fixed an issue where organisation users with the appropriate type access were unable to update API Resource Metadata on an Authorisation Server. The permission configuration has been updated to include the required user type access rule, aligning it with access controls used across other Authorisation Server operations.

2.1.0#

This release introduces improvements to application management, federation visibility, API family configuration, and mobile usability. It also includes multiple fixes addressing validation issues, endpoint generation behaviour, and user interface consistency across the Directory.

New features#

New Application Details Experience

The Application Details page has been redesigned to present information in a clearer and more structured layout. Key information such as flags and core application details is now displayed prominently at the top of the page, while detailed sections are collapsed by default to improve readability and navigation.

Identity Provider (IDP) Creation Wizard

A new guided wizard simplifies the process of creating Identity Providers. The wizard provides clearer visual feedback during configuration and consolidates the creation of an IDP and its version into a single flow, making the setup process more intuitive.

Federation Visibility for Applications

Applications that participate in a federation now display clear visual indicators within the UI. A Federated tag is shown on the application page, and a collapsible section provides visibility into the federation hierarchy, including the current entity, parent entity, and trust anchor.

Enhancements#

API Families Configuration Clarity

Additional helpers and contextual guidance have been introduced when configuring API Families, helping users better understand certification types and configuration requirements during creation.

Improved Mobile Navigation

The sidebar behaviour on mobile devices has been redesigned to better match expected interaction patterns. The sidebar now opens as a partial overlay instead of a full-screen panel, allowing users to maintain context with the underlying page while navigating.

Prepopulated Configuration Fields

Certain configuration forms now support prepopulated values, reducing manual input and improving consistency when creating new resources.

Improved Endpoint Generation in Wizards

Endpoint generation logic has been improved when creating API resources through the wizard. The system now correctly generates endpoint patterns based on the actual API version and properly handles version numbers and dot notation within endpoint paths.

Bug fixes#

Application Assertion Confirmation

Fixed an issue where the "Generating Assertion" confirmation dialog was incorrectly displayed when generating an assertion for an already locked application. The confirmation dialog is now only shown when appropriate.

Domain Mapping Validation Feedback

Fixed an issue where disabling a Domain Mapping that was still in use did not display the error returned by the API. Users now receive clear feedback when the action cannot be completed.

Authorisation Server IDP Configuration Button

Fixed an issue where the Add IDP Configuration button remained enabled even when the Authorisation Server was inactive. The button is now correctly disabled when the server is not active.

Suspended Application Deletion

Fixed an issue preventing suspended applications from being deleted directly from the Application Details page.

Domain Users Page Refresh

Fixed an issue where updates to Domain User information were not reflected immediately in the interface until the page was refreshed.

Flag Confirmation Dialog Text

Corrected wording in the Disable Flag confirmation dialog, where the term "certification" was incorrectly displayed instead of "flag".

API Family Endpoint Validation

Resolved several issues related to API Family configuration, including preventing duplicate endpoint definitions, correcting version handling for generated endpoints, and improving validation when defining endpoint patterns.

Reference Data Role Validation

Fixed an issue preventing the creation of Authorisation Domain Roles when the description exceeded the allowed character limit. Validation now correctly enforces the maximum supported length.

2.0.0#

This release introduces new ecosystem configuration capabilities, clearer metadata visibility, and usability improvements across the Directory UI, alongside multiple fixes improving stability, validation, and administration workflows.

New features#

API Families Configuration via Reference Data

API Families can now be configured through Reference Data to control which API families are available in the ecosystem. This allows ecosystem operators to centrally manage supported API families and provides participants with a clear, authoritative view of available APIs.

Certificate Description Field

Certificates now support a Description field to help identify their purpose. The Description can be provided during certificate creation and updated later, improving clarity for participants managing certificates across multiple environments.

Authorisation Server Details Experience

A redesigned Authorisation Server details page introduces a clearer, more structured layout. Key information such as flags and core server details is easier to identify, with sections grouped and collapsed by default to improve readability.

Federation Endpoint Visibility

Federation details now display all relevant federation endpoints instead of only the Fetch endpoint. This improves transparency when configuring, validating, and troubleshooting Federation integrations.

Enhancements#

Authority Organisation Context

Authorities now clearly indicate which Organisation they belong to when viewed under Reference Data. When applicable, an Organisation tag links directly to the associated Organisation. Legacy Authorities include an explanation clarifying that they were created under the previous model and are retained for reference and migration purposes.

Role Type Clarity

The UI now clearly explains the difference between Federation roles and Directory roles, including how metadata behaves differently between them. This reduces confusion when role metadata does not propagate for Federation roles.

Layout & Usability Improvements

Several Directory pages now use a unified layout with improved spacing, pagination, and visual consistency, including Organisations, Authorisation Mapping, Domain Users, Terms & Conditions, and Audit History. Navigation clarity and overall readability have been improved across these areas.

Organisation Creation Flow Standardisation

The legacy "New Organisation" button has been removed, and the guided Organisation creation wizard is now the standard way to create Organisations.

Standardised Enable / Disable Terminology

Action labels across the Directory have been standardised to Enable / Disable to improve clarity and consistency when managing resources.

Terms & Conditions Management

Data Administrator users can now manage the "Participant Terms & Conditions Signing required?" setting when editing Organisations. See Terms & Conditions for more details.

Logo Upload Experience

Logo uploads now display an image preview before saving. Drag-and-drop uploads are consistently supported across Organisations, Servers, and Applications.

Bug fixes#

Fixed missing actions for approved IDP versions

Resolved an issue where actions were not displayed for approved IDP versions.

Fixed Organisation ID regeneration issues

Resolved issues affecting Organisation ID regeneration during the Organisation creation flow.

Fixed unnecessary duplicate backend requests

Eliminated duplicate backend requests in Reference Data pages to improve performance.

Fixed validation gaps in Authorisation Server configuration

Improved validation when configuring Authorisation Servers to prevent invalid configurations.

Fixed flag management and configuration visibility

Resolved issues affecting flag management and configuration visibility across the UI.

Fixed icon visibility issues

Corrected icon visibility issues across the UI for improved visual consistency.

Fixed Federations page access when Federations disabled

The Federations page is no longer reachable when Federations are disabled in the ecosystem.

Improved Application edit performance

Reduced unnecessary backend calls when editing Applications to improve performance.

Fixed Organisation filtering issues

Resolved filtering issues when using My Organisations filter.

Fixed incorrect placeholder text in document signing dialogs

Corrected placeholder text displayed in document signing dialogs for clarity.

Fixed missing required field indicators

Added missing required field indicators in Application configuration screens to improve form clarity.

General stability improvements

Multiple stability, consistency, and reliability improvements across the Directory UI.