# Version 23.12

December 2023

## Changelog

**Sandbox Service**
* Optimized sandbox allocation, simplified request handlers.
* Added topology definition caching.
* Enabled hidden networks in topology.
* Added monitoring functionality.
* Fixed certificate generation for Windows.

**KYPO Ansible Stage One**
* Added support for network monitoring.

**Training Service**
* Included info about linear training definition creation.
* Switched the table of instances' training run sandbox IDs.
* Removed the prefix of the newly uploaded training definition.

**Adaptive Training Service**
* Included info about adaptive training definition creation.
* Switched the table of instances' training run sandbox IDs.
* Removed the prefix of the newly uploaded training definition.

**Frontend**
* Added new advanced settings for the linear training progress tool.
* Refactored Sandbox pool API communication and agenda table.
* Removed broken reference graph views.
* Fixed ATD simulator appearance.
* Migrated to Angular 15 and Angular Material 15.

# Version 23.07.1

July 2023

This release fixes one additional issue upon allocating a singleton sandbox from a sandbox pool.

## Changelog

**Frontend**

* Fixed an erroneous call upon allocating a single sandbox.

# Version 23.07

July 2023

## Changelog
**Sandbox Service**
* Dockerfile: fixed failing build 
* Fixed handling of images without denoted size

**KYPO Ansible Stage One**
* Moved Guacamole to a separate Ansible role

**Training Service**
* Added hint deletion optimization for training with a large number of sandboxes
* Updated input size limits for Assessment level

**Adaptive Training Service**
* Fixed and updated the Training Simulating Tool upload file check and upload

**Answers Storage Service**
* Fixed allocation id naming inconsistency when building sandboxes

**Frontend**
* Fixed and extended sorting options in tables for user-and-group, training instances, and sandbox definitions
* Fixed managing and styling of elements in questionnaires, notes, instructions, and learning outcomes when creating training definitions
* Fixed the faulty notification for the test mode of training questionnaires 
* Fixed the display of styled items in training preview mode
* Added new items to the Resources overview (Networks and Ports)
* Added markdown support to more inputs when creating training definition
* Fixed the disappearance of single-letter inputs in training definition notes and learning outcomes
* Fixed designer naming inconsistencies in linear training definition

# Version 23.04

April 2023

## Changelog
**Sandbox Service**
* Allocation_id in calls for answers storage is now included, condition for build fail is changed.
* Sandbox uuid is updated to serve as a key to store variant answers in the database.

**Training Service**
* Exported information from the training instance has now correct level ids.
* A whole new module for cheating detection is added. 

**Elasticsearch Service**
* Command filtering was updated to allow an optional command type parameter.

**Answers Storage Service**
* An endpoint was added to delete sandbox references and answers by allocation ID.

**Frontend**
* An interface was added for the new module for cheating detection.
* Visual notification of Docker containers was added.
* A topology legend was updated with new visual information and styling.
* In progress visualization for supervizors, a column layout was fixed.

# Version 22.12

December 2022

## Changelog
**Sandbox Service**
 * First sandbox allocation stage can be restarted if it fails.
 * Access to the admin panel can now be with GitLab ci variables when building the sandbox service image.
 * Optimized endpoints for deletion of multiple sandboxes.
 * Integration of docker containers into sandbox definitions.
 * Added force parameter to single sandbox deletion.
 * Switched from sandbox id to sandbox uuid - this change affects many endpoints that are now called with the sandbox uuid as a parameter. Sandbox allocation unis object was not affected by this change and still has the same numerical id as before. 
 * sandbox uuid was added to the allocation ansible inventory.

**Mitre Technique Service**
*  MITRE updated to version October 2022

**User And Group Service**
* Removed stack trace error content from Java services.
* Endpoint to retrieve users by given ids now anonymizes the users if the requesting user does not have the necessary roles. Other endpoints now throw an exception in that case.
* Users now must provide access to their names when logging in through OIDC.

**Training Service**
* Removed stack trace error content from Java services.
* Authorization requirements for various REST endpoints are stricter now.
* Added functionality to export score from training instance.
* Instance access codes are trimmed during instance creation.
* Non-local instances cannot be created/edited without having a pool assigned.
* Changed sandboxId type to string.
* Added automatic check if logging works for training events and commands.
* Added maxAchievableScore field to ClusteringLevelDTO, which contains the maximum score achievable in the specific level.
* Added a new endpoint for clustering visualization.

**Adaptive Training Service**
* Removed stack trace error content from Java services.
* Authorization requirements for various REST endpoints are stricter now.
* Instance access codes are trimmed during instance creation.
* Non-local instances cannot be created/edited without having a pool assigned.
* Changed sandboxId type to string.
* Added automatic check if logging works for training events and commands.

**Elasticsearch Service**
* Removed stack trace error content from Java services.
* Changed sandboxId type to string.
* Added option to filter commands retrieved from elasticsearch.

**Smart Assistant Service**
* Removed stack trace error content from Java services.

**Answers Storage Service**
* Removed stack trace error content from Java services.
* Changed sandboxId type to string.

**Training Feedback Service**
* Removed stack trace error content from Java services.
* Changed sandboxId type to string.

**Frontend**
* Projects are united under the `kypo*` prefix instead of the `kypo2*`.
* The expiration date of a group now works as expected.
* Users can be filtered by their full names. Support of filtering by ID added.
* API calls within the sandbox agenda are refactored and optimized. An improved polling strategy is used.
* Spice console loading is moved to the backend, and its status is checked periodically when hovering topology nodes.
* Sandbox ID is replaced with the sandbox UUID.
* Resource page is refactored and provides more information and filtering options.
* Pool detail table supports sorting now.
* Sandboxes can now be dynamically allocated.
* Sandboxes can be deleted by group according to their state.
* Adaptive model simulator is now available to the instructors.
* Assessment visualization is refactored, and its dependency on elasticsearch was dropped.
* Save strategy of non*local training instances is changed.
* Instructor can export the score of all trainees from a training instance.
* Instructor can now see a command timeline for each trainee in ongoing training.
* Walkthrough visualization is part of the post-training analysis.
* Fix infinite loading of pool size in instance overview table for records with deleted pools.
* Automatic and systematic check of whether logging of events and commands works is present in the Training Runs table.
* Progress visualization is refactored and provides a zoomable timeline.
* Statistical dashboard now contains clustering and overview visualization.

# Upgrading from the previous version
 * Since the last version, the config.yml was updated - note the changes in config.yml and set all required fields.
 * Due to the change to sandbox uuid, it is recommended to remove all sandboxes from the instance and migrate the Django database to apply the change.