/
Version Compatibility and Behavior

Version Compatibility and Behavior

Overview

License Optimizer (LO) for Confluence helps manage and optimize Confluence license usage by dynamically assigning and revoking application access based on group membership. Its functionality and integration behavior—especially with Single Sign-On (SSO)—varies depending on the version. This document outlines key behavioral differences and compatibility with Confluence versions.

Version Compatibility

License Optimizer Version

Confluence Compatibility

License Optimizer Version

Confluence Compatibility

1.6.5 and earlier

Confluence 7 – Confluence 8

2.0.0 – 2.0.1

Confluence 7 – Confluence 8

1.7.0 (new version)

Confluence 9

Note: Version 1.7.0 is the latest release, designed specifically for Confluence 9. It is based on version 1.6.5 and does not continue the 2.x branch of development.

Behavior Differences by Version

Versions Before 2.0.0 (including 1.6.5 and 1.7.0)

  • SSO should not modify Access group memberships.

  • LO manages group membership internally to ensure consistency.

  • External changes to the Access group (e.g., by SSO) can cause cache inconsistencies, potentially disrupting license management.

Best Practice:
Ensure that SSO is used strictly for authentication and not for group assignment into Access groups.

Although version 1.7.0 reverts to the stable pre-2.0.0 behavior, it incorporates several improvements that were introduced in the 2.x series:

  • Extended Analytics: Enhanced reporting and insights for license usage and group activity.

  • Continuous Access Check: You can enable periodic access checks to notify users immediately if their access is lost. Enabling this feature can result in frequent requests, which may prevent the system or node from entering sleep mode, potentially increasing resource usage. Disabling this feature means users won't be informed in real time and may experience delays in regaining access.

Versions 2.0.0 – 2.0.1 (discontinued)

  • LO introduced a new behavior: upon processing a request, it temporarily adds users to the Access group before performing authorization checks.

  • If the user is not authorized, LO removes them from the Access group after a short delay.

  • This behavior allows SSO to optionally add users to Access and/or Login groups during authentication.

Recommended SSO Configuration:

  • Add users to the Login Group (for first-time users only).

  • Add users to the Access Group (to grant Confluence access).

  • LO will automatically remove users who are added to Access but not in the Login Group.

Important: This version line has been discontinued and is not compatible with Confluence 9.

Summary

  • For Confluence 9, use License Optimizer 1.7.0 (based on stable version 1.6.5).

  • For Confluence 7–8, use either 1.6.5 (stable) or 2.0.1 (with temporary access logic).

  • Avoid using SSO to manage Access group membership in versions prior to 2.0.0 or after reverting to 1.7.0.