acra v0.85.0 Release Notes

Release Date: 2018-03-15 // about 4 years ago
  • ๐Ÿš€ 0.85.0, March 15th 2018


    ๐Ÿ’ฅ Breaking changes:

    ๐Ÿ”ง Introducing a new more flexible configuration format for AcraCensor rules. AcraCensor doesn't support the old format, all users should migrate (don't worry, it's a simple procedure).

    Search through encrypted data

    You now can run SQL queries over encrypted AcraStructs allowing users to search through sensitive data without exposing it. This feature is only available in Acra Enterprise version.

    Transparent proxy mode

    TLDR: Transparent proxy mode allows you to configure AcraServer to encrypt records in specific database columns without altering the application code.

    ๐Ÿ“œ The application flow doesn't need to change: application sends SQL requests through AcraConnector and AcraServer to the database. AcraServer parses each request, encrypts the desired values into AcraStructs, and passes the modified requests to the database. To retrieve the decrypted data, your application talks to AcraServer again: upon receiving the database response, AcraServer tries to detect AcraStructs, decrypts them, and returns the decrypted data to the application.

    โšก๏ธ Transparent proxy mode is useful for large distributed applications where updating the source code of each client app separately would be complicated.

    To enable this mode, you need to create a separate encryptor configuration file (acra-encryptor.yaml) that describes which columns to encrypt and provide a path to it in the AcraServer configuration file (or via CLI params --encryptor_config_file=acra-encryptor.yaml).

    ๐Ÿ“š Read more details in the Readme and in the Acra documentation section dedicated to Transparent encryption.

    (#285, #309, #314).

    AcraCensor โ€“ SQL firewall to prevent SQL injections

    TLDR: Improved stability of AcraCensor, switched to more flexible rules' configuration.

    ๐Ÿ’ฅ Breaking changes: Introducing a new format for configuration files, the previous format is no longer supported, you should migrate to the new one.

    ๐Ÿ†• New configuration file format allows configuring the allowlist and the denylist separately or simultaneously.

    The allow handler allows something specific and restricts/forbids everything else. The allowall handler should be a final statement as that means that all the other queries will be allowed.

    The deny handler allows everything and forbids something specific. The denyall means "block all queries!" (that haven't been allowed or ignored before).

    ๐Ÿ”ง For each handler, there are settings that regulate queries, tables, and patterns. The order of priority for the lists is defined by their position in the configuration file. The processing priority for each list is as follows: queries, followed by tables, followed by patterns.

    (#298, #297, #304, #306).

    ๐Ÿ“š Read more in AcraCensor docs.

    โž• Added version to the configuration file. This allows detecting an outdated configuration easily. From now on, AcraCensor supports explicit configuration version and logs errors if the configuration is not valid (#321).

    ๐Ÿ‘Œ Improved parsing of SQL queries with prepared statements (#303, #283).

    ๐Ÿ‘Œ Improved error handling for queries that AcraCensor can't parse (#291, #284).

    โž• Added ability to log unparsed queries to a separate log file for the debugging and configuration purposes. Sometimes AcraCensor can't parse all of the incoming queries and it is useful to have a separate log for them.

    How to use it: Provide the path to the unparsed queries log file in the configuration file parse_errors_log: unparsed_queries.log (#295).

    ๐Ÿ‘Œ Improved support of PostgreSQL queries ("RETURNING" clause) and quoted identifiers (now you can use "tablename" and WHERE "column"=1) (#296).

    ๐Ÿ›  Fixed the bug in QueryCapture log that caused duplicated of records in the log to appear (#318).


    ๐Ÿ›  Fixed handling of null-size packets in PostgreSQL protocol (#286).

    ๐Ÿ›  Fixed handling of setting a custom connection API port (#294).

    ๐Ÿ›  Fixed handling of the plain text data response: if the database returns a plain text response, it is redirected "as is" (#305).

    ๐Ÿ›  Fixed handling of casted placeholders in expressions like SELECT $1::type1::type2 FROM table1 WHERE column1=$2::type3::type4 (#328).

    ๐Ÿ‘Œ Improved code quality (some refactoring here and there) (#302, #301).

    AcraServer, AcraTranslator, AcraConnector

    ๐Ÿ”จ Refactored logs and error messages got even more descriptive and user-friendly (#312, #299, #317).

    โž• Added on-start version logging to make it easier to understand which version is running (#319).

    โž• Added versioning for configuration files of each service (#322).

    โž• Added exporting version to metrics (#330, #320).

    ๐Ÿ“š Updated some configuration parameters descriptions for better user-friendliness (please see our docs of AcraConnector and AcraServer for detailed descriptions of each parameter and usage examples) (#329).


    โšก๏ธ Updated AcraWriter for ActiveRecord (Ruby), fixed dependencies, added support of mysql2 adapter (#287).

    โšก๏ธ Updated AcraWriter for Django (Python), fixed potential encoding issues (#293, #292).

    โšก๏ธ Updated AcraWriter for C++, improved cpp codec usage (#290, #289).

    โž• Added bitcode for AcraWriter iOS and added Swift example project (#327, #326, #325, #324, #323, #323, #307).

    ๐Ÿ‘Œ Improved distribution of AcraWriter for Android, now it's available via Maven (#310).


    โž• Added more tests and then โ€” added even more tests. We just love automating things! (#331, #311, #308, #292).

    โšก๏ธ Updated the version of pyyaml used in the tests due to CVE-2017-18342. This change doesn't affect the users of Acra, it only affects our test suite (#300).


    • โšก๏ธ Updated Docker files, added more comments, and updated Go version (#313, #288).

    Example projects and demos:

    iOS Swift example project that shows how to generate AcraStructs with and without Zones.

    Android example project that shows how to integrate AcraWriter library into Android app using maven, and then to generate AcraStructs with and without Zones, and to decrypt them using AcraTranslator.

    ๐Ÿ”ง AcraCensor demo that shows how to configure AcraCensor for SQL injections prevention in OWASP Mutillidae 2 example app.

    ๐Ÿ’Ž Protecting data in a Rails application demo based on AcraServer, PostgreSQL, and Ruby on Rails client application.

    Protecting metrics in TimescaleDB demo based on AcraServer, TimescaleDB, and Grafana.

    ๐Ÿ”ง Transparent proxy mode demo that shows how to configure AcraServer in Transparent proxy mode to protect Django-based application.

    Related blog posts:

    ๐ŸŒ The difference between SQL firewalls and Web Application Firewalls.

    ๐Ÿ— Engineering details on how we built AcraCensor.

    ๐Ÿ”‹ Features coming soon:

    ๐Ÿ”Œ Pseudonymisation: an early version of pseudonymisation library/plugin for Acra for transparent data pseudonymisation.

    ๐Ÿ”Š Cryptographically protected audit log: protection for logs against tampering.

    ๐Ÿ“š Documentation:

    ๐Ÿ“š Updated AcraServer documentation to describe Transparent mode in more details.

    ๐Ÿ“š Updated AcraCensor documentation to describe the new configuration format and procedures for migration from the previous one.

    ๐Ÿ“š Updated AcraWriter documentation for iOS and Android to reflect the improved installation ways.

Previous changes from v0.76

  • Core:

    • ๐Ÿ‘ SSL / TLS support

    ๐Ÿ‘ Now you can use PostgeSQL with SSL/TLS settings enabled. Acra supports two modes of connection between AcraServer and the database: using SSL/TLS or using Secure Session (#113, #119).

    • Unix sockets

    ๐Ÿ‘ Acra now supports usage of both TCP and Unix Sockets as a connection layer between AcraWriter <-> AcraProxy <-> AcraServer.

    โœ… Tests

    • Updated integration test suit to support multiple connection modes between the Acra components and the database (#115, #117, #118, #120).
    • Added Docker image to make testing easier (#104).


    • โž• Added support of Go 1.10, removed support of older Go versions (<1.6).
    • โž• Added support of Ubuntu 17.10, Ubuntu 16.04, Ubuntu 14.04, Debian Stretch.
    • โšก๏ธ Updated dependency libraries (libthemis and libcrypto) to use the latest ones.

    ๐Ÿ“š Documentation:

    • ๐Ÿ“š Updated the documentation and tutorials to reflect the latest changes.