UniFFI binding for Cedarling

UniFFI (Universal Foreign Function Interface) is a tool developed by Mozilla to simplify cross-language bindings, primarily between Rust and other languages like Kotlin, Swift, and Python. It allows Rust libraries to be used in these languages without manually writing complex foreign function interface (FFI) bindings. For eg. developing iOS applications typically involves languages like Swift or Objective-C. However, with the advent of UniFFI, it’s now possible to use rust code iOS apps.

Speaking about Cedarling, it interacts with outside world mainly using 3 interfaces init, authz and log. The UniFFI binding for Cedarling wraps the init, authz and log interfaces of Cedarling and uses the Procedural Macros to expose them to other languages. It also exposes the required Structs and Enums used as parameters and return-types in these interfaces.

Exposed Functions

• Cedarling::load_from_json

Loads a Cedarling instance from a JSON configuration.

#[uniffi::constructor]
pub fn load_from_json(config: String) -> Result<Self, CedarlingError>

Usage in Swift:

let cedarling = try Cedarling.loadFromJson(config: jsonString)

• Cedarling::load_from_file

Loads a Cedarling instance from a configuration file.

#[uniffi::constructor]
pub fn load_from_file(path: String) -> Result<Self, CedarlingError>

Usage in Swift:

let cedarling = try Cedarling.loadFromFile(path: "/path/to/config.json")

• Cedarling::authorize

Handles authorization requests.

#[uniffi::method]
     pub fn authorize(
         &self,
         tokens: HashMap<String, String>,
         action: String,
         resource_type: String,
         resource_id: String,
         payload: String,
         context: String,
     ) -> Result<AuthorizeResult, AuthorizeError> 

Usage in Swift:

let result = try cedarling.authorize(tokens: tokenMap, action: "read", resourceType: "file", resourceId: "123", payload: "{}", context: "")

• Cedarling::pop_logs

Retrieves logs as JSON strings.

#[uniffi::method]
pub fn pop_logs(&self) -> Result<Vec<String>, LogError> 

Usage in Swift:

let logs = try cedarling.popLogs()

• Cedarling::get_log_by_id

Retrieves a log entry by ID.

#[uniffi::method]
pub fn get_log_by_id(&self, id: &str) -> Result<String, LogError>

Usage in Swift:

let log = try cedarling.getLogById(id: "log123")

• Cedarling::get_log_ids

Get all log ids

#[uniffi::method]
pub fn get_log_ids(&self) -> Vec<String>

Usage in Swift:

let ids = try cedarling.getLogIds()

• Cedarling::get_logs_by_tag

Get logs by tag, like log_kind or log level.

#[uniffi::method]
pub fn get_logs_by_tag(&self, tag: &str) -> Result<Vec<String>, LogError> {

Usage in Swift:

let logs = try cedarling.getLogsByTag(tag: "DEBUG")

• Cedarling::get_logs_by_request_id

Get all logs by request_id

#[uniffi::method]
pub fn get_logs_by_request_id(&self, request_id: &str) -> Result<Vec<String>, LogError>

Usage in Swift:

let logs = try cedarling.getLogsByRequestId(request_id: "12434-32323-43434")

• Cedarling::get_logs_by_request_id_and_tag

Get log by request_id and tag, like composite key request_id + log_kind.

#[uniffi::method]
pub fn get_logs_by_request_id_and_tag(
     &self,
     request_id: &str,
     tag: &str,
 ) -> Result<Vec<String>, LogError>

Usage in Swift:

let logs = try cedarling.getLogsByRequestIdAndTag(request_id: "12434-32323-43434", tag: "Decision")

---

Last update: 2025-02-19
Created: 2025-02-18