Unreleased

No notable changes.

0.13.0 - 2026-02-18

Added

• request_context option to Cerbos::Client methods to attach additional metadata to the request for inclusion in audit logs (#292)

  Requires a policy decision point server running Cerbos 0.51+.

• Cerbos::Output::CheckResources::Result::Output#action attribute returning the action that was being evaluated when the output was produced (#292)

  Requires a policy decision point server running Cerbos 0.51+.

0.12.0 - 2025-08-12

Added

• Cerbos::Hub::Stores::Client for interacting with policy stores in Cerbos Hub (#251)

0.11.0 - 2025-06-03

Added

• Support for multiple actions in Cerbos::Client#plan_resources (#239)

  Requires a policy decision point server running Cerbos 0.44+.

Removed

• Support for Ruby 3.1 (#234)

0.10.0 - 2025-02-06

Added

• Cerbos::Client#check_health method to perform health checks on the policy decision point server (#221)

0.9.1 - 2024-07-15

Changed

• Updated google-protobuf version requirement to also accept 4.26+ (#171)

0.9.0 - 2024-06-10

Changed

• Use attr for principal and resource attributes (#157)

  This makes the API consistent with policy expressions. attributes is still supported for backwards compatibility, but is now deprecated.

• Increased google-protobuf version requirement to 3.21.12+ to avoid failure to load protovalidate extension field descriptors (#159)

Removed

• Support for Ruby 3.0 (#158)

0.8.0 - 2024-01-12

Added

• grpc_metadata option to Cerbos::Client constructor and request methods to add gRPC metadata (a.k.a. HTTP headers) to requests to the policy decision point (#132)

0.7.0 - 2023-06-07

Added

• Support for user-defined policy rule outputs (#100)

  Requires a policy decision point server running Cerbos 0.27+.

Removed

• Support for Ruby 2.7 (#90)

0.6.1 - 2023-03-23

Removed

• Unused generated code (#83)

0.6.0 - 2022-07-01

Added

• Support for schema validation in Cerbos::Client#plan_resources (#32)

  Requires a policy decision point server running Cerbos 0.19+. Cerbos::Output::PlanResources#validation_errors will always return an empty array if the client is connected to an earlier version of Cerbos.

  As a result, Cerbos::Output::CheckResources::Result::ValidationError has moved to Cerbos::Output::ValidationError. Attempting to access the class via the old namespace will print a deprecation warning and return the new class.

0.5.0 - 2022-06-09

Added

• Allow symbol keys in nested attributes hashes (#28)

0.4.0 - 2022-06-03

Added

• on_validation_error option to Cerbos::Client#initialize (#22)

Changed

• Minor documentation fixes (#21)

0.3.0 - 2022-05-13

Added

• More helper methods (#11)
  • Cerbos::Client#allow? for checking a single action on a resource
  • Cerbos::Output::CheckResources#allow_all? and Cerbos::Output::CheckResources::Result#allow_all? for checking if all input actions were allowed

0.2.0 - 2022-05-12

Changed

• Increased grpc version requirement to 1.46+ to avoid installing a native gem compiled for x86_64-darwin on arm64-darwin (#8)

0.1.0 - 2022-05-12

Added

• Initial implementation of Cerbos::Client (#2)