Version 4.1.11

Released: March 08, 2023

Status: End of life

Changes

This version includes fixes and backports from series 4.3, 4.4, and 4.5dev0.

Dependencies

The Python Transifex client was remove and replace with the new Go based client. This client is OS dependent and needs to be installed manually when working with translations (https://github.com/transifex/cli).

Pin Jinja2 version to workaround Sphinx bug. Sphinx Jinja2 dependency is not pinned or immutable, and causes the installation of an incompatible version breaking builds.

Improved the Python 3.10 compatibility. Add a compatibility module to encapsulate import of the Iterable class. Python 3.10 is not supported. This change was merged to allow automated rendering of platform files like GitLab CI and Docker build file.

REST API

The validation errors in the document metadata API were incorrectly causing HTTP 500 server errors. A custom REST API exception handler was added to workaround inconsistent validation exception behavior in the Django REST framework and ensure validation error raise a HTTP 400 error instead.

Tags

Sanitize tag labels to avoid XSS abuse (CVE-2022-47419: Mayan EDMS Tag XSS). This is a limited scope weakness of the tagging system markup that can be used to display an arbitrary text when selecting a tag for attachment to or removal from a document.

It is not possible to circumvent Mayan EDMS access control system or expose arbitrary information with this weakness.

Attempting to exploit this weakness requires a privileged account and is not possible to enable from a guest or an anonymous account. Visitors to a Mayan EDMS installation cannot exploit this weakness.

It is also being incorrectly reported that this weakness can be used to steal the session cookie and impersonate users. Since version 1.4 (March 23, 2012) Django has included the httponly attribute for the session cookie. This means that the session cookie data, including sessionid, is no longer accessible from JavaScript. https://docs.djangoproject.com/en/4.1/releases/1.4/

Mayan EDMS currently uses Django 3.2. Under this version of Django The SESSION_COOKIE_HTTPONLY defaults to True, which enables the httponly for the session cookie making it inaccessible to JavaScript and therefore not available for impersonation via session hijacking. https://docs.djangoproject.com/en/3.2/ref/settings/#session-cookie-httponly

Django’s SESSION_COOKIE_HTTPONLY setting is not currently exposed by Mayan EDMS’ setting system, therefore it is not possible to disable this protection by conventional means.

Any usage of this weakness remains logged in the event system making it easy to track down any bad actors.

Due to all these factors, the surface of attack of this weakness is very limited, if any.

There are no known actual or theoretical attacks exploiting this weakness to expose or destroy data.

Testing

Support multi psycopg2 versions for testing. Upgrade testing now uses PYTHON_PSYCOPG_VERSION_PREVIOUS to install the previous version of the library.

Other

  • Install OS and Python dependencies as separate makefile targets.

  • Support a local environment config file names config-local.env. This file is ignored by Git and meant to override values of config.env. against PostgreSQL.

  • Move SearchModel.flatten_list to the common app utils.py module.

  • Move the helper module version.py to the dependencies app.

  • GitOps improvements and backports:

    • Add configurable remote branch for GitOps.

    • Add makefile targets to trigger standalone builds.

    • Reuse Python build in stages.

    • Convert branches into literals.

    • Remove duplicated code in jobs.

    • Split GitLab CI targets into their own makefile.

    • Increase artifact expiration.

    • Add PIP and APT caching to documentation and python build stages.

    • Add GitLab CI job dependencies.

    • Enable Buildkit builds.

    • Use APT proxy and cache in more places.

    • Cache Alpine APK packages.

    • Clean up cache directory definitions.

    • Update APT cache to be at .cache/apt.

    • Add multi cache support.

    • Add GitLab CI cache template tags.

    • Update deployment stages.

Removals

  • Transifex Python client

Upgrade process

Important

If using a direct deployment, Supervisord must be upgraded to version 4.2.2.

Docker Compose

Check the Docker upgrading chapter for the complete upgrade process.

Backward incompatible changes

  • None

Issues closed

  • None