guideCKBox On-Premises

# 2.6.0 (2024-10-10)

# Features

  • Added the ability to set a custom thumbnail for non-image assets

    Added a new endpoint POST:/assets/{{assetId}}/thumbs which allows to upload an image that would become a custom thumbnail for the asset.

  • Added Private Categories

    The feature will give administrators the ability to mark certain categories of assets as private, restricting access to its content to selected users or groups, adding an additional layer of control over content sharing.

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.5.0 (2024-08-27)

# Features

  • Introduced the Permissions feature

    Permissions enable fine-grained control over user access to specific features and actions. By assigning permissions, admins can regulate user interactions with assets, categories, and folders. Permissions introduce control over:

    • Accessing a Category
    • Creating an Asset
    • Deleting an Asset
    • Modifying an Asset
    • Modifying Asset Metadata
    • Creating a Folder
    • Modifying a Folder Metadata
    • Deleting a Folder
  • Added a configuration option to indicate the maximum file size that CKBox can allow during upload

    A new CKBox On-Premises configuration option max_file_size_in_bytes_limit will allow to limit a maximum file upload size from the default 32GB limit to that indicated by the configuration.

# Fixes

  • Improved the performance of workspaces

    Workspace information is fetched in a more optimized way.

  • Improved error handling in Webhooks feature

  • Improved the performance of uploading multiple files to a folder

    Enhanced the upload progress of multiple files, especially when targeting folders.

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.4.3 (2024-07-16)

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.4.2 (2024-06-04)

# Fixes

  • Updated handling of asset mime-type during asset update

    Resolved an issue with updating mimetypes when asset data is updated. The mimetype will be correctly updated in accordance with the new file extension.

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.4.1 (2024-04-23)

# Other changes

  • Improved overall performance

    Enhanced responsiveness and speed of particular actions.

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.4.0 (2024-03-12)

# Features

  • Introduced Webhooks

    We have added support for webhooks within the application. By integrating Webhooks, third party apps will be able to be notified whenever:

    • an asset is modified,
    • an asset is overwritten,
    • an asset is copied,
    • an asset cache should be invalidated,
    • a folder is created,
    • a folder is modified,
    • a folder wis removed.
  • Changed requirements for uploading files

    categoryId is required no more while uploading assets to CKBox. Both categoryId and folderId are now optional, and target upload category is deduced from the category settings defined by admins.

# Fixes

  • Fixed issues with requesting images with capitalized extensions

    Image URL containing capitalized extension such as JPG is now considered valid.

  • Improved overall performance

    Enhanced responsiveness and speed of selected actions.

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.3.1 (2024-01-23)

# Fixes

  • Fixed issues related to uploading huge files, resolving random timeout errors

    Increased actual upload timeout to 4 hours, ensuring successful completion of large file uploads without encountering timeout errors.

  • Fixed problems with abruptly closed connections

    Implemented measures to prevent unexpected connection interruptions, properly handling abruptly closed connections, for example, while closing CKBox during upload.

  • Improved overall performance

    Enhanced responsiveness and speed of the workspaces.

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.3.0 (2023-12-19)

# Other changes

  • Improved integration with CKBox application

    Some of the internal mechanisms for workspaces were adapted to allow editing external web images via CKBox’s Image Editor.

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.2.0 (2023-11-14)

# Features

  • Added an option to globally limit allowed extensions for all workspaces in the environment

    New endpoints for changing global extensions limits were added:

    • GET:/admin/environmentConfig returns an object describing environment extensions limit containing properties:

      • allowedExtensions which is an array of strings containing extensions that are allowed to upload in the environment
      • isAllowedExtensionsEnabled which is a flag indicating whether limiting extensions in the environment is enabled or disabled
    • PUT:/superadmin/environmentConfig allows to modify the configuration of allowed extensions for the entire environment
      Note: The above endpoint is accessible for SuperAdmin users only.

  • Extended the payload of the response of fetching workspaces list GET:/workspaces

    The endpoint will now include additional properties:

    • allowedExtensions is an array of strings containing all extensions that are allowed in all workspaces in the environment
    • extensionsInUse is an array of strings containing a list of the asset extensions that are currently in use for all workspaces in the environment

    Note: Extended response is accessible for SuperAdmin users only.

# Fixes

  • Improved performance of the assets processing

  • Fixed the problem of uploading large files to CKBox

    Timeout issues during upload of files that could take >30 min to upload have been fixed.

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.1.0 (2023-09-27)

# Features

  • Added global environment configuration management in CKBox

    New endpoints for changing global environment configuration were added:

    • GET:/superadmin/workspacesTemplate returns a list of categories that should be created in new workspaces created in the environment
    • PUT:/superadmin/workspacesTemplate allows to modify the list of categories created in a new workspace

# Fixes

  • Fixed the problem with composite image editing operations

    Introduced version 2 of the image editing endpoint POST:/assets/{assetId}/editImage that preserves the order of the operations throughout all image file formats:

    1. Flip is applied before anything else.
    2. Then rotation is applied.
    3. Then crop is applied.
    4. Then resize is applied.

    This fixes the problem of incorrectly cropped image part if it was previously flipped or rotated.

  • Fixed a problem while connecting with a database thru the TLS connection

    The TLS connection wasn’t possible, now TLS can be used properly.

# Other changes

  • Deprecated query parameter workspaceId in some of the assets-related endpoints

    The workspaceId parameter, which was previously used as a query parameter in our endpoints, has been deprecated and is not required anymore for the following endpoints: GET:/assets/{assetId}/offset, POST:/assets/{assetId}, PATCH:/assets/{assetId}, PATCH:/assets/{assetId}/metadata.

  • Added validation rules for maximum width and height in Image Editing in CKBox

    Maximum edited image dimension (width or height) is now limited to 16383px.

  • Improved mechanism to release unused database connections

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 2.0.0 (2023-08-22)

Note: The CKBox On-premises 2.0.0 does not contain any breaking changes, the versioning is simply shared with the frontend part of the CKBox, which contains a breaking change.

# Fixes

  • Fixed the problem with handling files containing some of UNICODE combined accents in the filename

  • Fixed problems with uploading multiple files at once in CKBox configuration with a Postgres database

# Other changes

  • Adjusted the process of image editing

    The description and the tags assigned to an asset will now be copied to the newly created asset if the edited image is saved as a new file.

  • Improved the performance of image rescaling

    Adjusted image processing to speed up image processing and increase the rescaling performance.

  • Optimized CPU usage

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 1.6.0 (2023-07-13)

# Features

  • Added metadataProcessingStatus property to the asset’s metadata

    The new property provides information about the status of processing image metadata.

  • Added the Asset overwrite feature

    A new POST:/assets/:assetId endpoint has been added to enable users to overwrite the asset’s file content.

  • Added the Asset offset feature

    A new GET:/assets/:assetId/offset endpoint has been added providing functionality to determine the position offset of an asset in a category or folder based on specific sorting conditions.

  • Added the Workspaces feature

Workspaces create completely separate instances of CKBox within one environment, which is effectively close to what can be achieved using separate environments.

Added 4 new endpoints dedicated to workspace management:

  • POST:/superadmin/workspaces creates a new workspace within the environment
  • PUT:/superadmin/workspaces/:workspaceId modifies the workspace
  • DELETE:/superadmin/workspaces/:workspaceId deletes the workspace
  • GET:/workspaces returns the list of all workspaces to which the user has access to
  • Added the Image Editing feature:

    An image editing API allows to perform various operations on image assets. The editing operation can be performed via a new endpoint POST:/assets/:assetId/edit.

    Some common image operations supported by such an API include:

    • Crop: This operation can select a specified portion of an image, removing the rest of it. This helps focus on a particular subject or remove unwanted elements.
    • Resize: This operation allows to change the dimensions (width and height) of an image, either proportionally or by specifying custom dimensions.
    • Rotate: This operation enables the rotation of an image by a set angle. 90 degrees clockwise or counterclockwise.
    • Flip: Flipping allows the user to mirror an image horizontally or vertically

# Fixes

  • Fixed Redis cluster TLS options

    Fixed TLS options for a Redis cluster to make the connection to a Redis cluster possible for on-premises.

  • Improved the performance of image processing

# Other changes

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 1.5.0 (2023-05-30)

# Features

  • Added support for REDIS_USER

    The environmental variable allows to set the user while connecting to the Redis instance.
    More details can be found in the online documentation.

# Fixes

  • Fixed the asset metadata that used specific orientation

    CKBox will now correctly save metadata about the image’s dimensions, taking into account the orientation contained in the EXIF.

  • Improved sample in API docs for the POST:/assets endpoint

    Adjusted the API docs sample to better reflect the interface of the data returned from the endpoint.

  • Added REST API documentation for the copy/move feature

    The REST API documentation now contains detailed docs and samples for 3 new endpoints related to copying/moving assets in CKBox:

    • POST:/assets/copy
    • POST:/assets/move
    • POST:/assets/namesExist
  • Improved the overall performance of copy/move operations

  • Improved the error handling of corrupted or empty files

# 1.4.0 (2023-04-18)

The 1.3.0 version was skipped to unify the versioning of CKBox On-premises with the cloud-based application.

# Features

  • Added the Copy assets feature

    Assets can now be copied between categories and folders. A new POST:/assets/copy endpoint has been added to enable users to copy assets. This endpoint also supports the action (replace or rename) to be performed during the operation.

  • Added the Move assets feature

    Assets can now be moved between categories and folders. A new POST:/assets/move endpoint has been added to enable users to move assets. This endpoint also supports the action (replace or rename) to be performed during the operation.

  • Added the Assets exist feature

    A new POST:/assets/namesExist endpoint has been added, which can be used to check whether assets with the same names exist in the target location. Such operation becomes useful when resolving conflicts when copying or moving assets.

  • Added the parentId property to the GET:/folders/:folderId endpoint response

    GET:/folders/:folderId will now include information about the identifier of the ancestor folder in each folder.

  • Added the assets count in folders and categories

    The behavior of the assetsCount property in GET:/categories/categoryId has been changed to reflect the assets count only for that category, without descendants folders. Additionally, a new totalAssetsCount property has been added, providing the number of all assets, taking into account the descendant folders of a given category.

  • Added the assetsCount property to the GET:/folders/:folderId endpoint

    The GET:/folders/:folderId endpoint now includes the additional assetsCount property containing the number of assets in that particular folder.

# Fixes

  • Ignored extension letter case when checking for allowed extensions

    Assets operations are now case-insensitive, it fixed some of the validation issues.

  • Disabled signature check on the /limits endpoint

  • Disabled marking assets as recent on GET:/assets/:assetId requests

# Other changes

  • Improved API docs for folders

  • Improved performance of counting assets

  • Improved performance of processing GIFs and BMP

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 1.2.0 (2023-02-28)

# Features

  • Added natural sorting to folders

    Folders returned on all REST API endpoints are now sorted in the natural order.

  • Added possibility to return descendants to n-depth when retrieving folder branch

    GET:/folder/:folderId/branch endpoint will now accept an additional query parameter depth which will control the depth of the returned folder tree.

  • Included categoryId in assets and folder objects in subfolders

    All folders within the folder structure will now include additional information about the parent category. Before this information was only returned to the root folders.

  • Removed GET /assets/:assetId/metadata endpoint from REST API

    The GET /assets/:assetId/metadata endpoint for returning metadata for the asset is now deprecated and no longer operational.

  • Removed property categoryId from the PATCH /assets/:assetId endpoint

    The categoryId property was removed from the supported payload properties in that endpoint.

# Fixes

  • Fixed an issue related to uploading the wrong Content-Type payload to CKBox

  • Fixed an issue with response hangup upon sending empty JSON to POST:/search

  • Fixed an issue related to validation mismatch when uploading a file to a folder

# Other changes

  • Added REST API documentation for the folders feature

# 1.1.0 (2023-01-23)

# Features

  • Added the /search API

    The new /search API allows searching assets by various properties like name, category, tags, and time range.
    More information can be found in the CKBox REST API documentation.

  • Added tags property to assets

    The new property allows for classifying your assets by tags.
    The tags are added to asset responses and can be used to filter search results.

  • Added metrics logs

    The new logs allow monitoring of the performance and stability of the CKBox On-premises.

# Other changes

  • Improved UX of the Insight Panel view in the management panel

    It is now possible to set a relative time frame for logs, so e.g. logs from the last hour can be checked.

  • Updated dependencies

    Selected dependencies have been updated to the latest versions, improving performance and security.

# 1.0.0 (2022-09-09)

# Features

  • Added On-Premise version of CKBox.

    The service allows for managing file assets and providing responsive versions of images.