Skip to main content

​
1.4.1

  • Expose X-Request-ID via .getRequestId() for both synchronous Oso and asynchronous Oso.Async instances. The X-Request-ID is a UUIDv4 generated per request.

​
1.4.0

  • Add non-blocking Oso.Async API.

​
1.3.1

  • Expand retry functionality to retry requests in more cases, including client-configured timeouts.

​
1.3.0

  • Add ability to set read and write timeouts separately.

​
1.2.1

  • Add OsoTimeoutException for timeout.

​
1.2.0

  • Add ability to set client timeout.

​
1.1.0

  • Stable release of ParityHandle for use with Oso Migrate.

​
1.1.0-alpha.2

  • Move ParityHandle to public API - users no longer need to import from internal package.

​
1.1.0-alpha.1

  • Add ParityHandle for use with unreleased Oso Migrate.

​
1.0.0

See the migration guide for details on upgrading from v0.x. This major release introduces a redesigned API surface for improved consistency and developer experience, including the new Query Builder API. Please consult the migration guide for a comprehensive list of breaking changes and instructions on adapting your code. Breaking Changes & New Features:
  • Package Structure: Public API is now primarily accessed via com.osohq.oso_cloud.Oso. Query-related methods are available through the QueryBuilder returned by oso.buildQuery().
  • Centralized Authorization Data API:
    • tell(name, ...args) is replaced by insert(Fact).
    • delete(name, ...args) is replaced by delete(Fact) for specific facts and a new delete(FactPattern) overload for pattern matching using ValuePattern.ANY and ValuePattern.ValueOfType.
    • get(name, ...args) is replaced by get(FactPattern) which allows wildcard matching.
    • bulkTell, bulkDelete, and bulk are replaced by the atomic batch(Consumer<BatchTransaction>) method, using tx.insert() and tx.delete() within the transaction.
  • Query API:
    • The previous query and authorizeResources methods are replaced by the new fluent Query Builder API, accessed via oso.buildQuery().
    • The Query Builder (com.osohq.oso_cloud.QueryBuilder) provides methods like and(), in(), withContextFacts(), and evaluate() (using EvaluateArgs.exists(), EvaluateArgs.values(), EvaluateArgs.map()) for constructing and executing flexible queries.
    • Queries returning unconstrained results (e.g., an admin can access everything) now yield "*" in the results list, consistent with Check APIs.
  • Local Check API:
    • Integrates with the new Query Builder API via evaluateLocalSelect() and evaluateLocalFilter() methods on the QueryBuilder for generating SQL.
    • Existing listLocal, authorizeLocal, and actionsLocal methods remain functional.

​
0.11.0

  • Add support for QueryBuilder and Local Authorization evaluation.

​
0.10.0

  • Added .equals() method for Value and Fact classes.

​
0.9.0

  • Add context facts support to actionsLocal, listLocal, authorizeLocal.

​
0.8.0

  • Increase the maximum number of connections used in the connection pool to 20. Previous default was 2 which limited the throughput a single client would handle.
  • Added a setMaxConnections method to configure the maximum number.

​
0.7.1

  • Specify a User-Agent to identify the Java and SDK client versions.
  • Treat all 2xx status codes as valid.

​
0.7.0

  • Use Fallback, if configured, for .get, .get_policy_metadata, and local check APIs if Oso Cloud returns an error (Requires Fallback 1.0.0 or later).
  • Use Fallback, if configured, if Oso Cloud returns an HTTP 400 error.

​
0.6.0

  • Remove extra argument from actionsLocal and mark old version as deprecated.

​
0.5.1

  • Add X-Request-ID header to uniquely identify individual API requests; include this ID in error messages for better debugging.

​
0.5.0

​
0.4.2

  • Add X-Request-ID header to uniquely identify individual API requests; include this ID in error messages for better debugging.

​
0.4.1

Removed undocumented & no longer in-use built-in Float type.

​
0.4.0

Added support for the local check API:
⌘I