10 releases (6 breaking)

0.8.1 Apr 19, 2024
0.7.1 Feb 7, 2024
0.7.0 Dec 1, 2023
0.6.0 Nov 16, 2023
0.1.0 Oct 19, 2022

#88 in Operating systems

Download history 64/week @ 2024-03-10 55/week @ 2024-03-17 96/week @ 2024-03-31 75/week @ 2024-04-07 275/week @ 2024-04-14 124/week @ 2024-04-21 83/week @ 2024-04-28 70/week @ 2024-05-05 132/week @ 2024-05-12 106/week @ 2024-05-19 74/week @ 2024-05-26 115/week @ 2024-06-02 129/week @ 2024-06-09 159/week @ 2024-06-16 161/week @ 2024-06-23

568 downloads per month

GPL-3.0-or-later

345KB
2K SLoC

Birdcage

GitHub GitHub issues Contributor Covenant Discord Crate Documentation

Birdcage logo

About

Birdcage is a cross-platform embeddable sandboxing library allowing restrictions to Filesystem and Network operations using native operating system APIs.

Birdcage was originally developed for use by the Phylum CLI as an extra layer of protection against potentially malicious dependencies (see the blog post for details). To better protect yourself from these security risks, sign up now!

Birdcage focuses only on Filesystem and Network operations. It is not a complete sandbox preventing all side-effects or permanent damage. Applications can still execute most system calls, which is especially dangerous when execution is performed as root. Birdcage should be combined with other security mechanisms, especially if you are executing known-malicious code.

Example

An example for using Birdcage's API can be found in ./examples/sandbox, which runs an application with CLI-configurable restrictions applied.

Trying to run without any exceptions will produce an error:

$ cargo run --example sandbox -- echo "Hello, Sandbox\!"
Error: Os { code: 13, kind: PermissionDenied, message: "Permission denied" }

Running the same command with explicit permissions allows execution:

$ cargo run --example sandbox -- -e /usr/bin/echo -e /usr/lib echo "Hello, Sandbox\!"
Hello, Sandbox!

Check out cargo run --example sandbox -- --help for more information on how to use the example.

Supported Platforms

  • Linux via namespaces
  • macOS via sandbox_init() (aka Seatbelt)

Dependencies

~0–9MB
~80K SLoC