Welcome to the Machina Tools SDK for Java v2.8
Ionic Machina allows any developer to add data access, control and protection to their application with a few lines of code. With no background in data security or cryptography, you can quickly and confidently add data access management and protection to your application.
You can find an introduction to Machina including a variety of "getting started" tutorials at Ionic's developer portal.
The Machina Tools SDK is offered for a wide range of languages and platforms. In this package, we have included the SDKs for the following (click to view the documentation):
If you require the SDK for another platform or language, or have other questions, please contact Ionic.
The Java SDK requires version 7 or greater of the Java Runtime Environment (JRE). At the time of this release, testing was completed using JREs version 7 through version 12. The Java SDK should be compatible with future JRE releases without modification.
Abstract Class KeyServicesMinimal
The new class KeyServicesMinimal has been added, providing default implementations of most KeyServices interfaces. This enables users to provide custom KeyServices implementations with minimal boilerplate code.
The new abstract class BatchCipherAbstract has been added, with implementations using the AES-CTR and AES-GCM algorithms. Users may employ these classes to perform cryptography operations on discrete sets of logically related plaintexts (for example, multiple columns of a single database table row).
- Additional detail describes the use and purpose of the GetKeysexternal id data structures.
- The error code definitions are linked in more places within the API documentation.
- Expected return values from getoperations are better documented, detailing expectations with regard to null values and exceptions.
- Additional SDK classes implement the io.Serializableinterface, facilitating usage within external frameworks such as Apache Spark.
- The source code has been updated to comply with up-to-date versions of the code quality tools checkstyle, SpotBugs, and pmd.
- Additional trace has been added to help diagnose issues with the available ProfilePersistor
- Provide method to specify a desired quantity of keys that match an External ID in a GetKeysRequest.
Service Endpoint Updates
- All SDK calls to the Machina service layer use the v2.4 service HTTP endpoints.
- The method findKey()now correctly returns a list of entries.