toml

Function library for TOML marshalling and unmarshalling operations.

TOML Functions

Enables TOML configuration file processing in SAPL policies for systems using TOML-based configuration management. Parse TOML configuration files into SAPL values for policy evaluation, or serialize authorization configurations into TOML format for application configuration files and infrastructure management.

---

toml.tomlToVal(Text toml)

tomlToVal(TEXT toml): Converts a well-formed TOML document toml into a SAPL value representing the content of the TOML document.

Example:

policy "permit_based_on_config"
permit
where
   var configToml = "[resource]\nowner = \"alice\"\nclassification = \"CONFIDENTIAL\"\naccessLevel = 3";
   var config = toml.tomlToVal(configToml);
   config.resource.owner == subject.name;

---

toml.valToToml(value)

valToToml(value): Converts a SAPL value into a TOML string representation.

Example:

policy "export_policy_config"
permit
where
   var policyConfig = {"permissions":{"user":"bob","actions":["READ","WRITE"],"resources":["/api/data"]}};
   var configToml = toml.valToToml(policyConfig);
   // configToml contains TOML-formatted configuration

---