io.Manager Documentation

Changelog

4.0

4.0.0

Release date: 28.08.2026

Breaking Changes

For more details, see the Upgrade section.

  • The io.Manager Admin UI is now compatible with the io.Manager Server only when their major and minor versions match. For example, io.Manager Admin UI 4.0.x is compatible with io.Manager Server 4.0.x (any patch), but io.Manager Admin UI 4.0.0 isn't compatible with io.Manager Server 4.1.0. Make sure to upgrade both packages together so that their major and minor versions stay aligned. Compatibility with @interopio/manager-api, io.Connect Desktop, and io.Connect Browser is unchanged.
  • The onUnauthorizedResponse() callback on the AuthProvider interface is now also invoked on 403 Forbidden responses, in addition to the existing 401 Unauthorized trigger. Consumers implementing a custom AuthProvider should review the callback's behavior for the new case.

New Features

  • Added granular permission-based access controls throughout the Admin UI.
  • Added product selection to the command-creation flow. Select io.Connect Desktop or io.Connect Browser first, then a command reported by that product, and finally a compatible active session for the selected product and version.
  • Added a "Migrate legacy layouts" page, available from the "Layouts" menu when advanced Layouts are enabled.
  • Reworked the "Groups" page. It now lists groups from every source with their name, description, and the granular permission groups and nested groups they resolve to. You can create, edit, and delete stored groups, which are managed in the Admin UI, while config groups (defined through the auth_extra_groups configuration) and built-in default groups are read-only and can only be viewed. A "Group source" filter narrows the list by source.
  • The "User" page now shows the groups a user "Resolves to" - the full set of granular permission groups and nested groups the user effectively belongs to once their assigned groups are expanded, alongside the groups assigned to them directly.

Improvements & Bug Fixes

  • The "Layouts" page now persists the "Layout Visibility" and "Layout Type" filter selections per user across page reloads.
  • Improved the "Platform Configs" page. Each config file in the "Config File" list is now badged "System" or "Custom", indicating whether apps can read it through the io.Manager client API.
  • Removed the "Data", "Sessions", and "Audit logs" cards from the "Server Info" page.
  • Fixed a bug where the Session details card displayed the literal text ${session.id} instead of the session ID, and where the end time would render as "undefined" when the session was still active.
  • Fixed a bug where the "Add User" form would show validation errors one at a time and flip into a loading state before validation had finished. Required-field errors are now collected and shown together, and the loading indicator only appears once validation passes.
  • Fixed a bug where the "Preferences" and "Machines" grids clobbered each other's saved column state.
  • Fixed a bug where adding a new version on the "Platform Configs" page cleared the selected platform version and config file while leaving the previous version's files listed in "Config File", so selecting one of those files opened nothing. The current selection is now kept when a version is added.
  • Fixed a bug where the "Create a new app preference" dialog showed an empty editor after a user and an app that already had preferences were selected, and saving without editing it kept those preferences instead of the empty object shown. The editor now shows the preferences stored for the selected user and app.

Dependency Changes

The following new dependencies have been added to the package:

  • @ag-grid-enterprise/core version ^32.3.5

The following dependencies have been removed from the package:

  • lodash

The following dependencies have been updated:

  • @interopio/manager-api from version ^4.1.0 to ^5.0.0
  • @interopio/theme from version ^3.0.1 to ^4.0.0
  • @okta/okta-auth-js from version ^7.12.1 to ^8.0.0

3.0

3.1.0

Release date: 30.01.2026

New Features

  • The Admin UI now persists the user session after login when using Basic authentication. Persisting the user session is enabled by default and is managed via a signed JWT stored in a session cookie. To disable session cookies and persisting the user session, set the useSessionCookie property of the auth_basic object to false:
<AdminUI
    apiURL="http://localhost:4356/api"
    auth="basic"
    auth_basic={{
        useSessionCookie: false
    }}
/>

Improvements & Bug Fixes

  • Updated the toggle label for disabling app definitions to "Disable app".
  • Added scroll to the Layout definition preview in the confirmation step so that large content no longer hides the control buttons.
  • Improved the dialog message when deleting a Layout to show its visibility status.
  • Improved the success alert when creating or updating a Layout to show its visibility status.
  • Improved feedback when exporting all data.
  • Updated the "User" card description in the "Dashboard" page.
  • Replaced the Layout visibility filter control with a multi-select dropdown. Now private, public and shared Layouts are displayed simultaneously by default.
  • Improved the UI for command execution.
  • Improved the "Sessions" dropdown when adding new commands:
    • Sessions are now sorted from newest to oldest.
    • Each session now includes the io.Connect platform version and user machine name.
    • Inactive sessions are no longer listed.
  • Improved AG Grid tables across the Admin UI. The column state now persists with the option to reset it on demand.
  • Fixed a bug where the contents of AG Grid tables couldn't be copied to the clipboard.
  • Fixed a bug where the JSON editor and preview block backgrounds blended into the app background in light mode.
  • Fixed a bug that allowed the creation of user groups containing only a whitespace.
  • Fixed a bug that allowed creation of Layouts containing only a whitespace, which prevented them from being edited after creation.
  • Fixed a bug where numeric type inputs in the definition step for adding or editing app definitions converted numeric values to string values.
  • Fixed a bug where some empty string values weren't correctly removed in the advanced definition view when adding or editing app definitions.
  • Fixed a bug where navigating to the new app definition page while still editing an existing app automatically filled the new app form with the app definition values of the currently edited app.
  • Fixed a bug where switching between io.Connect and FDC3 definition types when adding apps in advanced view didn't reset the form.
  • Fixed a bug where importing from FDC3 app directory caused multiple validation errors to stack, displaying the wrong error on top.
  • The "accessList" property now appears as an empty array in the confirmation step when adding or editing apps if user groups aren't added.
  • Fixed a bug where filtering multi‑word user groups in the "Groups" dropdown incorrectly concatenated words when the highlighted character was positioned before a space.
  • Fixed a bug where leaving an empty JSON object when editing an app definition in advanced view resulted in a blank screen.
  • Fixed a bug causing a 500 error when adding a Layout to a user group.
  • Fixed a bug where attempting to edit a nonexistent Layout caused endless loading.
  • Fixed a bug where typing the "true" or "false" strings in the "Owner" input when adding or editing a Layout was parsed as true or false Boolean values.

Dependency Changes

The following new dependencies have been added to the package:

  • @ag-grid-enterprise/side-bar version ^32.3.5

The following dependencies have been updated:

  • @interopio/manager-api from version ^4.0.0 to ^4.1.0

3.0.0

Release date: 11.07.2025

⚠️ Note that the following io.Manager NPM packages will now be published in the public NPM registry:

Previous versions of the packages will still be available in the private JFROG registry.

Breaking Changes

  • Dropped React 17 support.
  • Removed the users top-level configuration property. Its options will now be implied from the auth top-level configuration property.

ℹ️ For more details on all changes related to the Admin UI and the required upgrade steps, see the Upgrade section.

Improvements & Bug Fixes

  • The Admin UI now shows the io.Manager license status.

  • Added the ADMIN_UI_PORT environment variable for users of the manager-admin-ui docker image. Defines the port on which the web server listens internally. Defaults to 80.

Dependency Changes

The following new dependencies have been added to the package:

  • @ag-grid-community/client-side-row-model version ^32.3.5
  • @ag-grid-community/styles version ^32.3.5
  • @ag-grid-enterprise/row-grouping version ^32.3.4
  • @ag-grid-enterprise/set-filter version ^32.3.5
  • @interopio/theme version ^3.0.1
  • bootstrap version ^5.3.6
  • date-fns version ^4.1.0
  • highlight.js version ^11.11.1
  • react-router-dom version ^7.6.0

The following dependencies have been removed from the package:

  • @ag-grid-enterprise/all-modules
  • @interopio/schemas
  • @types/ajv
  • @types/lodash
  • @types/react-tag-autocomplete
  • ci
  • jsoneditor
  • jsoneditor-react

The following dependencies have been updated:

  • @ag-grid-community/core from version ^25.0.1 to ^32.3.4
  • @ag-grid-community/react from version ^25.0.1 to ^32.3.5
  • @ag-grid-enterprise/server-side-row-model from version ^25.0.0 to ^32.3.5
  • @auth0/auth0-react from version ^1.9.0 to ^2.3.0
  • @interopio/manager-api from version ^3.0.1 to ^3.1.7
  • @interopio/utils from version ^1.2.0 to ^2.0.1
  • @monaco-editor/react from version ^4.4.6 to ^4.7.0
  • @okta/okta-auth-js from version ^7.5.1 to ^7.12.1
  • @okta/okta-react from version ^6.8.0 to ^6.10.0
  • react-select from version ^5.2.2 to ^5.10.1
  • react-tag-autocomplete from version ^6.3.0 to ^7.5.0
  • react-virtuoso from version ^2.7.1 to ^4.12.7
  • reactstrap from version ^9.0.1 to ^9.2.3
  • use-react-router-breadcrumbs from version ^3.1.0 to ^4.0.1

The following peer dependencies have been removed from the package:

  • react-router-dom

The following peer dependencies have been updated:

  • react from version >=17.0.2 to ^18.3.1
  • react-dom from version >=17.0.2 to ^18.3.1

2.0

2.0.5

Release date: 19.11.2024

Improvements & Bug Fixes

  • Updated branding.
  • Refactored the UI for Basic authentication.

2.0.4

Release date: 01.11.2024

New Features

  • Added REACT_APP_AG_GRID_LICENCE_KEY environment variable - use to provide a license key for AG Grid.
  • Added Docker health checks.

Improvements & Bug Fixes

  • Fixed incorrect link on the "Dashboard" page pointing to the "Feedback" page.

2.0.3

Release date: 12.09.2024

Improvements & Bug Fixes

  • Fixed a bug where sometimes state changes to the custom authenticator passed to the <AdminUI /> component would not be taken into account.

2.0.2

Release date: 09.09.2024

Improvements & Bug Fixes

  • Fixed a bug where the button to download a command result in the "View Command" page would download an invalid ZIP file.

2.0.1

Release date: 04.09.2024

Improvements & Bug Fixes

  • Authentication type None: Adjusted authUser prioritization when the io.Manager Admin UI is running in an io.Connect Desktop container.
  • Group GLUE42_SERVER_ADMIN will now appear in the user group selection UI without needing to be manually created.

2.0.0

Release date: 15.05.2024

Breaking Changes

  • Auth providers aren't exported as classes from the package any more. To use them, set the auth property of the component to the corresponding string.

New Features

  • Added support for Okta authentication.

Improvements & Bug Fixes

  • Fixed a CSS bug that was offsetting the app menu.
  • Fixed a bug that caused the JSON editor to break when updating apps by changing their name.

1.0

1.2.0

Release date: 22.03.2024

New Features

  • Added support for importing apps from existing FDC3 AppD.
  • Added support for defining FDC3 apps in the server.
  • Added built-in login components for none and basic flows.
  • Added view modal for machine displays.

Improvements & Bug Fixes

  • Fixed default group colDef configuration.
  • Disabled sorting, filtering, grouping for some Grid columns to reflect new Data Request restrictions.

1.1.0

Release date: 12.03.2024

New Features

  • Added <AutoLogin /> and <UserPassLogin /> helper components.

1.0.1

Release date: 07.03.2024

Improvements & Bug Fixes

  • Made "title" and "caption" in the app definition optional.
  • Added a "folder" field under "customProperties".
  • Added a "includeInWorkspaces" field under "customProperties" that defaults to true.
  • Fixed a bug where validation would fail if the value of the "allowMultiple" field value was changed.

1.0.0

Release date: 04.12.2023

Breaking Changes

New Features

  • Added a response interceptor.

0.1

0.12.0

Release date: 19.07.2023

New Features

  • Added support for None authentication.

0.11.1

Release date: 11.05.2023

New Features

  • Extended Auth0 configuration options.

0.11.0

Release date: 11.05.2023

New Features

0.10.0

Release date: 31.03.2023

New Features

  • Added checkbox that allows skipping validation when importing Layouts.
  • Added checkbox that allows skipping validation when importing apps.

0.9.0

Release date: 03.11.2022

New Features

  • Added support for remote configurations.

0.8.0

Release date: 19.09.2022

New Features

  • Added support for exporting data.

0.7.1

Release date: 24.08.2022

Improvements & Bug Fixes

  • Fixed build.

0.7.0

Release date: 24.08.2022

New Features

  • Added the option to skip validation for app definitions.

0.6.1

Release date: 23.03.2022

Improvements & Bug Fixes

  • Fixed schema validation of apps and Layouts.

0.6.0

Release date: 21.03.2022

New Features

  • Added support for Basic authentication.

0.5.11

Release date: 17.03.2022

New Features

  • Add an optional logOut() method to authentication providers.

0.5.10

Release date: 17.03.2022

Improvements & Bug Fixes

  • Fixed issues with destructuring in Custom authentication.

0.5.9

Release date: 14.03.2022

Improvements & Bug Fixes

  • Fixed font size in the <Footer /> component.
  • Fixed the "Info" link.
  • Removed "Coming soon..." from the "Dashboard".