Struct PolicyBuilder 

pub struct PolicyBuilder { /* private fields */ }

Implementations

impl PolicyBuilder

pub fn target(self, target: Target) -> Self

Examples found in repository

examples/basic.rs (line 10)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let policy = Policy::builder("document-read")
        .target(Target::action("document:read"))
        .condition(Condition::equals("resource.owner_id", "actor.id"))
        .effect(Effect::Permit)
        .build()?;

    let engine = PolicyEngine::from_policies([policy]);

    let request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123")
        .resource_attr("owner_id", "user-123");

    let decision = engine.evaluate(&request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

examples/default_deny.rs (line 11)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Engine denies by default when no policy matches.
    let engine = PolicyEngine::from_policies([Policy::builder("allow-write")
        .target(Target::action("document:write"))
        .effect(Effect::Permit)
        .build()?]);

    let read_request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123");

    let decision = engine.evaluate(&read_request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Deny);

    // Override the default effect to allow unmatched requests.
    let permissive_engine = PolicyEngine::from_policies(Vec::<Policy>::new())
        .with_default_effect(Effect::Permit);

    let read_request = Request::new().action("document:read");
    let decision = permissive_engine.evaluate(&read_request)?;
    println!("permissive decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

pub fn condition(self, condition: Condition) -> Self

Examples found in repository

examples/basic.rs (line 11)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let policy = Policy::builder("document-read")
        .target(Target::action("document:read"))
        .condition(Condition::equals("resource.owner_id", "actor.id"))
        .effect(Effect::Permit)
        .build()?;

    let engine = PolicyEngine::from_policies([policy]);

    let request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123")
        .resource_attr("owner_id", "user-123");

    let decision = engine.evaluate(&request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

pub fn effect(self, effect: Effect) -> Self

Examples found in repository

examples/basic.rs (line 12)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let policy = Policy::builder("document-read")
        .target(Target::action("document:read"))
        .condition(Condition::equals("resource.owner_id", "actor.id"))
        .effect(Effect::Permit)
        .build()?;

    let engine = PolicyEngine::from_policies([policy]);

    let request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123")
        .resource_attr("owner_id", "user-123");

    let decision = engine.evaluate(&request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

examples/default_deny.rs (line 12)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Engine denies by default when no policy matches.
    let engine = PolicyEngine::from_policies([Policy::builder("allow-write")
        .target(Target::action("document:write"))
        .effect(Effect::Permit)
        .build()?]);

    let read_request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123");

    let decision = engine.evaluate(&read_request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Deny);

    // Override the default effect to allow unmatched requests.
    let permissive_engine = PolicyEngine::from_policies(Vec::<Policy>::new())
        .with_default_effect(Effect::Permit);

    let read_request = Request::new().action("document:read");
    let decision = permissive_engine.evaluate(&read_request)?;
    println!("permissive decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

pub fn build(self) -> Result<Policy>

Examples found in repository

examples/basic.rs (line 13)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let policy = Policy::builder("document-read")
        .target(Target::action("document:read"))
        .condition(Condition::equals("resource.owner_id", "actor.id"))
        .effect(Effect::Permit)
        .build()?;

    let engine = PolicyEngine::from_policies([policy]);

    let request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123")
        .resource_attr("owner_id", "user-123");

    let decision = engine.evaluate(&request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}

examples/default_deny.rs (line 13)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Engine denies by default when no policy matches.
    let engine = PolicyEngine::from_policies([Policy::builder("allow-write")
        .target(Target::action("document:write"))
        .effect(Effect::Permit)
        .build()?]);

    let read_request = Request::new()
        .action("document:read")
        .actor_attr("id", "user-123");

    let decision = engine.evaluate(&read_request)?;
    println!("decision: {:?}", decision);
    assert_eq!(decision, Decision::Deny);

    // Override the default effect to allow unmatched requests.
    let permissive_engine = PolicyEngine::from_policies(Vec::<Policy>::new())
        .with_default_effect(Effect::Permit);

    let read_request = Request::new().action("document:read");
    let decision = permissive_engine.evaluate(&read_request)?;
    println!("permissive decision: {:?}", decision);
    assert_eq!(decision, Decision::Permit);

    Ok(())
}