Pre release (#601)

Lagovas · web-flow · commit cd2f5e858289 · 2022-11-16T14:17:36.000+02:00
* update changelog for release
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,11 +1,38 @@
 # Acra ChangeLog
 
-## [0.94.0](https://github.com/cossacklabs/acra/releases/tag/0.94.0), not released yet
+## [0.94.0](https://github.com/cossacklabs/acra/releases/tag/0.94.0), November 16th 2022
 
 _Core_:
 
-- **AcraServer**:
-  - Added new section to encryptor config called `database_settings`. [#532](https://github.com/cossacklabs/acra/pull/532)
+In this release we deprecated [Zones functionality](https://docs.cossacklabs.com/acra/security-controls/zones/) and all flags and CLI parameters related to it. These flags will be removed in the next versions. Acra will warn about deprecations.
+Acra Community Edition supports separate encryption keys linked to the `ClientIDs` and allows to manage key switching via [TLS certificates](https://docs.cossacklabs.com/acra/guides/integrating-acra-server-into-infrastructure/client_id/#tls-certificate).
+[Acra Enterprise Edition](https://docs.cossacklabs.com/acra/enterprise-edition/) supports more flexible mapping between users/apps and encryption keys via [SQL variables](https://docs.cossacklabs.com/acra/security-controls/client-id-sql-detection/).
+
+- **AcraServer, AcraTranslator, AcraKeymaker, AcraKeys, AcraRotate, AcraAddZone, AcraBackup, AcraLogVerifier, AcraPoisonRecordMaker, AcraRollback**:
+  - Added new CLI flags for better KMS support ([documentation page](https://docs.cossacklabs.com/acra/configuring-maintaining/key-storing/kms-integration/#aws-kms), [#552](https://github.com/cossacklabs/acra/pull/552), [#553](https://github.com/cossacklabs/acra/pull/553), [#554](https://github.com/cossacklabs/acra/pull/554)):
+    - `--kms_credentials_path=<filepath>` - path to configuration file specific for KMS type
+    - `--kms_type=[aws]` - type of KMS provider
+  - Added support of encrypting the Acra Master Key using AWS KMS key (key wrapping technique). [AWS KMS documentation page](https://docs.cossacklabs.com/acra/configuring-maintaining/key-storing/kms-integration/#aws-kms), [#552](https://github.com/cossacklabs/acra/pull/552).
+  - Added support of the several encryption strategies for keys in the keystore ([#556](https://github.com/cossacklabs/acra/pull/556)) and added new CLI flag:
+      - `--keystore_encryption_type` - specifies type of keys encryption for keystore. Accepts `env_master_key`, `vault_master_key`, `kms_encrypted_master_key`, `kms_per_client`. Read description of types on documentation pages of appropriate tools, for example [AcraKeymaker](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-keymaker/#keystore).
+  - Extended configuration of TLS options when storing ACRA_MASTER_KEY in HashiCorp Vault. [#578](https://github.com/cossacklabs/acra/pull/578)
+  - Added 12 flags related to OCSP/CRL support. You can find all of these flags in documentation on pages related to appropriate tool, for example [AcraKeymaker](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-keymaker/#hashicorp-vault). 
+- **AcraServer, AcraTranslator, AcraKeymaker, AcraKeys, AcraRotate, AcraAddZone, AcraTokens**:
+  - Added TLS support for Redis storage for Keystore. Added new 15 CLI flags related to TLS configuration. Read more on appropriate tool's page, for example [AcraKeymaker](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-keymaker/#redis). [#566](https://github.com/cossacklabs/acra/pull/566), [#565](https://github.com/cossacklabs/acra/pull/565)
+- **AcraServer, AcraTranslator, AcraKeymaker, AcraKeys, AcraRotate, AcraAddZone, AcraRollback**:
+  - Deprecated all Zones related CLI flags and API descriptions [#577](https://github.com/cossacklabs/acra/pull/577)
+- **AcraServer, AcraTranslator**:
+  - Improved resistance against memory leakage: in-memory cache for keystore now uses randomly generated symmetric key for key encryption instead of ACRA_MASTER_KEY. [#555](https://github.com/cossacklabs/acra/pull/555)
+  - Improved reloading on SIGHUP signals. [#557](https://github.com/cossacklabs/acra/pull/557)
+- **AcraServer**: 
+  - Added support of [HashiCorp Consul](https://www.consul.io/) as a configuration source for encryptor config. Acra can load configuration from the Consul instead of file. Added new CLI flag (`--encryptor_config_storage_type=[filesystem|consul]`) to switch source and Consul specific flags. Read more on [documentation page](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-server/encryptor-config/) about encryptor config and acra-server's [configuration description](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-server/#hashicorp-consul). [#568](https://github.com/cossacklabs/acra/pull/568)
+  - Improved support of searchable tokenization. AcraServer captures `SELECT` queries and update `WHERE` clauses to add support of filtering with consistent tokenization. [#581](https://github.com/cossacklabs/acra/pull/581)
+  - Improved searchable encryption with more complex queries. [#586](https://github.com/cossacklabs/acra/pull/586), [#592](https://github.com/cossacklabs/acra/pull/592), [#598](https://github.com/cossacklabs/acra/pull/598), [#599](https://github.com/cossacklabs/acra/pull/599), [#594](https://github.com/cossacklabs/acra/pull/594).
+  - Improved SQL parser (better compatibility across different SQL databases):
+    - Added support of `NULLS FIRST`/`NULLS LAST` ordering clauses, joins with subqueries [#547](https://github.com/cossacklabs/acra/pull/547)
+    - Added support of `RETURNING` clauses. [#584](https://github.com/cossacklabs/acra/pull/584)
+  - Improved processing prepared statement. [#580](https://github.com/cossacklabs/acra/pull/580), [#593](https://github.com/cossacklabs/acra/pull/593)
+  - Added new section to encryptor config called `database_settings`. [#532](https://github.com/cossacklabs/acra/pull/532), [#590](https://github.com/cossacklabs/acra/pull/590)
     - Contains subsections `mysql` and `postgresql`
     - Currently `mysql` subsection has one option, `case_sensitive_table_identifiers`, boolean, to configure whether table names should be considered case-sensitive when comparing with names in encryptor config
   - Table/column matching now works like this:
@@ -17,8 +44,19 @@ _Core_:
       - Table names are case-insensitive by default, could be changed with `case_sensitive_table_identifiers` option mentioned above
     Case-insensitive means the identifier is converted to lowercase before comparing with values from encryptor config, encryptor config should contain lowercase version of column/table name.
     Case-sensitive means identifiers are compared with values from encryptor config "as is", encryptor config should contain exactly the same identifier as in database schema.
+  - Removed deprecated `--tls_db_sni` flag. Now only `--tls_database_sni` is available. [#564](https://github.com/cossacklabs/acra/pull/564)
+  - Added support of separate configuration and specifying of CRL/OCSP settings for connections from database and applications. Added flags: `--tls_ocsp_[database|client]_required`, `--tls_[ocsp|crl]_[database|client]_check_only_leaf_certificate`, `--tls_[ocsp|crl]_[database|client]_from_cert`, `--tls_[ocsp|crl]_[database|client}_cache_size`, `--tls_[ocsp|crl]_[database|client}_cache_time`, `--tls_[ocsp|crl]_[database|client}_cache_size`. You can find all of these flags in documentation on pages related to appropriate tool, for example [AcraServer](https://docs.cossacklabs.com/acra/configuring-maintaining/general-configuration/acra-server/#tls). [#564](https://github.com/cossacklabs/acra/pull/564). 
+- **AcraTranslator**:
+  - Improved HTTP API performance. Refactored HTTP processing core. Now AcraTranslator uses golang's [HTTP server](https://pkg.go.dev/net/http) with [gin](https://github.com/gin-gonic/gin) router [#550](https://github.com/cossacklabs/acra/pull/550). Added support of:
+    - HTTP 2.0 connections additionally to HTTP 1.1
+    - Keep alive connections
+  - Added TLS support for HTTP API:
+    - `--http_api_tls_transport_enable=[true|false]` new flag added to turn on accepting TLS connections instead of raw TCP. Works only together with  `--http_api_enable=true`. [#550](https://github.com/cossacklabs/acra/pull/550)
+
+_Example projects and demos_:
+- [Python examples](https://github.com/cossacklabs/acra/tree/0.94.0/examples/python): updated to show searchable encryption feature. [#548](https://github.com/cossacklabs/acra/pull/548)
 
-## [0.93.0](https://github.com/cossacklabs/acra/releases/tag/0.93.0), May 27th 2021
+## [0.93.0](https://github.com/cossacklabs/acra/releases/tag/0.93.0), May 27th 2022
 This release brings type awareness which improves transparent encryption on AcraServer. Type awareness means that it's possible to tell AcraServer what are the original data types for fields. During decryption, AcraServer will convert decrypted fields to their original data types. No need to change client application code to work with "binary data".
 
 It's also possible to choose a default value for each data field if its decryption failed. AcraServer can send a a default value like "<encrypted data>" instead of decryption errors, making developers' and users' life easier.
diff --git a/benchmarks/config/acra-server.yaml b/benchmarks/config/acra-server.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 encryptor_config_file: /config/encryptor_config.yaml
 tls_ca: /ssl.ca/example.cossacklabs.com.crt
 tls_cert: /ssl.server/acra-server.crt
diff --git a/configs/acra-addzone.yaml b/configs/acra-addzone.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # path to config
 config_file: 
 
diff --git a/configs/acra-backup.yaml b/configs/acra-backup.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # import|export values are accepted
 action: 
 
diff --git a/configs/acra-keymaker.yaml b/configs/acra-keymaker.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # Client ID
 client_id: client
 
diff --git a/configs/acra-keys.yaml b/configs/acra-keys.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # path to config
 config_file: 
 
diff --git a/configs/acra-poisonrecordmaker.yaml b/configs/acra-poisonrecordmaker.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # path to config
 config_file: 
 
diff --git a/configs/acra-rollback.yaml b/configs/acra-rollback.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # Client ID should be name of file with private key
 client_id: 
 
diff --git a/configs/acra-rotate.yaml b/configs/acra-rotate.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # path to config
 config_file: 
 
diff --git a/configs/acra-server.yaml b/configs/acra-server.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # Path to AcraCensor configuration file
 acracensor_config_file: 
 
diff --git a/configs/acra-tokens.yaml b/configs/acra-tokens.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # path to config
 config_file: 
 
diff --git a/configs/acra-translator.yaml b/configs/acra-translator.yaml
@@ -1,4 +1,4 @@
-version: 0.93.0
+version: 0.94.0
 # Use clientID from TLS certificates or secure session handshake instead directly passed values in gRPC methods
 acratranslator_client_id_from_connection_enable: false
 
diff --git a/utils/version.go b/utils/version.go
@@ -26,7 +26,7 @@ import (
 // VERSION is current Acra suite version
 // store it as string instead initialized struct value to easy change/grep/sed/replace value via scripts or with
 // -ldflags "-X github.com/cossacklabs/acra/utils.VERSION=X.X.X"
-var VERSION = "0.93.0"
+var VERSION = "0.94.0"
 
 // Version store version info
 type Version struct {

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-version: 0.93.0`
	`1`	`+version: 0.94.0`
`2`	`2`	`encryptor_config_file: /config/encryptor_config.yaml`
`3`	`3`	`tls_ca: /ssl.ca/example.cossacklabs.com.crt`
`4`	`4`	`tls_cert: /ssl.server/acra-server.crt`