.. SPDX-FileCopyrightText: 2021 - 2025 Univention GmbH
..
.. SPDX-License-Identifier: AGPL-3.0-only

.. _consumer-changelog:

*********
Changelog
*********

Find information about deploying *OX Consumer* for user provisioning at :ref:`user-provisioning`.
This changelog documents all notable changes to *OX Consumer*.

This project follows `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_ format
and `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`_.


.. _consumer-changelog-v0.41.0:

v0.41.0
=======

Released: 2026-07-10

Added
-----

This version adds support for *OX Shared Accounts*.
You can now add UDM objects for shared account and corresponding shared account permissions.
For more information, see :ref:`usage-shared-accounts`.

*OX Shared Accounts* require a database to work properly.
The *OX Connector* now requires a PostgreSQL database to operate.
The database isn't part of the OX App Suite packaged and the OX Connector integration.
You need to provide it separately.
For more information, read :ref:`configure-database`.

.. warning::

    Before you upgrade from a previous version to ``v0.41.0``
    read :ref:`migration-v0.41.0`.
    Otherwise, this version of the *OX Connector* fails during start.

Fixed
-----

The ox-connector pod is now correctly updated and restarted when the `openXchange.auth.password`
value is changed.


.. _consumer-changelog-v0.36.2:

v0.36.2
=======

Released: 2026-03-17

Removed
-------

The property `groups` in the Functional Accounts module has been removed.
Adding groups to Functional Accounts was never supported
and thus not an available option in the Univention Management Console.
The logic that still made it possible to set groups via direct Univention Directory Manager access
has been removed.

.. important::
    If groups were used as Functional Account members,
    please add their members directly to the Functional Account.
    Attempting to add a group to a Functional Account will raise an error in UDM after this update.


.. _consumer-changelog-v0.36.1:

v0.36.1
=======

Released: 2026-03-12

Fixed
-----

Users can give deputy permissions to other users (`oxDeputyPermissionGivenTo`).
These references have to be updated on changes to that user. This was not done
in case of a move operation in LDAP. This has been fixed.

.. _consumer-changelog-v0.36.0:

v0.36.0
=======

Released: 4. Mar 2026

Changed
-------

:program:`OX Consumer` now uses the UDM property ``univentionObjectIdentifier``
instead of ``entryUUID`` for the functional account login template.
A functional account is a shared mailbox and calendar that multiple users share in :program:`OX App Suite`.
If your configuration uses ``entryUUID``,
consult the documentation for :program:`OX App Suite` and :program:`Dovecot`
to update the sign-in configuration to use ``univentionObjectIdentifier``.
Without this update,
users can't sign in to newly provisioned functional accounts.

.. important::

   Before you upgrade your production environment to *OX Consumer* ``0.36.0``,
   test the update in a test environment
   and verify that users can sign in to existing
   and newly created functional accounts.

After you upgrade to *OX Consumer* ``0.36.0``, validate the following:

* Create a new functional account after the upgrade and verify that it was created successfully.
* Verify that members can access the new functional account.
* If validation fails, don't proceed with upgrading additional environments. Contact contracted support before continuing.