SDK download and changelog

SDK Download

In order to download the SDK, log in to our Ekinops OEM customer portal.

About the SDK Changelog

Find below a record of updates, improvements and bug fixes applied to the SDK. It is intended to stay up-to -date with modifications and leveraging new features optimizations, and patches.

1.4.0 - September 16th, 2026

UPDATE

Added the "AI" and "NSFW" tags to the application database, providing additional information about application content.

1.3.2 - September 7th, 2026

SDK

Added a new encoding method based on the XH64 format.

1.3.1 –May 3rd, 2026

SDK

Fixing a mock for unit tests.

1.3.0 - February 20th, 2026

API

Added a new ` url_dependant ` attribute to categorization endpoint responses, allowing classifications to be applied at the full URL level rather than the subdomain level.

SDK

Added the GetDomainCategoryEx() API to the categorizer so that it can return url_dependant value.

1.2.1 - October 13th, 2025

Updater

Fixed an issue when using prefix where the updater was not queriyng the prefixed key for metrics.

Tooling

Added the ability to set command line arguments via environment variables.

1.2.0 - May 20th, 2025

SDK

Database
- Added GetApplicationIpRanges method to get all ranges for a given application

1.1.0 - April 2025

This version of the SDK requires a reset of applications stored in order for Risk Score to be available for all applications. See Reset a Specific Part of the Dataset for more information.

SDK

Schema
- Added RiskScore to Application Info.
Database
- Removed implementation using go-redis/v9 dependency.
- Added support to specify a custom database prefix.
Metrics
- Added recording of unknown domains for inclusion in automated feedbacks.

UPDATER

Added support to specify a custom database prefix.
Added optional telemetry output using OpenTelemetry.

TOOLING

Tool "add-test-domain"
- Added support to specify a custom database prefix.
Tool "remove-obsolete-lists" has been removed

1.0.1 - Fev 05, 2025

SDK

Validator
- Fixed an issue with IDNA validation happening even for ascii only domains.

1.0.0 - Dec 13, 2024

This SDK V1.0.0 is a major release, which introduces breaking changes from previous V0.x. Please review carefully and adapt any existing implementation.

In order to migrate from a previous version, a reset of the database is required. Please see our article Migrating to 1.0 for more information.

SDK

Metrics
- Introduced new Recorder interface to collect runtime usage metrics of the Categorizer.
- Added a default interface that store the metrics in the redis database.
Validator
- Introduced new Validator interface to automatically check and correct categorization inputs.
Categorizer
- Updated Categorizer creation to allow to specify optional Validator and MetricsCollector instances. Defaults are used if no other instance is provided.
Database
- Updated redis data structures from lists to sets to avoid creating duplicates (a reset of the database is required).

Updater

Updated redis data structures from lists to sets to avoid creating duplicates (a reset of the database is required).
Modified the Updater to collect all recorded runtime usage metrics and forward them to the server after a successful update.
Reworked the update process to avoid the possibility of losing updates.
Added an option to reduce parallelism of the updating process.

Tooling

Tool "add-test-domain"
- Added the ability to attach multiple application_ids to the same domain.
- Added the ability to remove the data associated with a given domain.
Tool "remove-obsolete-lists"
- Added a tool to remove obsolete list entries from the database after a successful transition to v1 sets.

0.9.0 - Nov 06, 2024

Categorize interface

Added input validation to the Categorizer interface

Database interface

Fixed behavior for GetThemeCategoryIds when the theme is empty.
Reinstated a Database interface implementation using github.com/redis/go-redis/v9 as a dependency.

Updater

Fixed application metadata to include logo ids if existing
Fixed the update process to avoid processing the last update multiple times
Optimized the processing of changes in an IP range

0.8.0 - Oct 11, 2024

Database Interface

Redis dependency changed from github.com/redis/go-redis/v9 to github.com/redis/rueidis.
Application logo information is now available through the SDK.

Tooling

A new binary is included in the release: olfeo-tools that allows adding domain data to an existing redis database.

0.7.0 - Sep 25, 2024

Categorizer interface

Added tracing to the method GetAdvancedDomainInfo.

0.6.0 - August 19, 2024

Database interface

Changed how domain theme information is provided.
Added new methods to Database interface: GetThemeInfo, GetThemeInfoList, GetThemeIds and GetThemeCategoryIds.

Olfeo OEM documentation