Skip to main content

oso is an open source policy engine for authorization that’s embedded in your application

Project description

oso

Development GitHub release (latest SemVer) Maven version NPM version PyPI version RubyGems version Crates.io version Slack

What is oso?

oso is an open source policy engine for authorization that’s embedded in your application. It provides a declarative policy language for expressing authorization logic. You define this logic separately from the rest of your application code, but it executes inside the application and can call directly into it. oso ships as a library with a built-in debugger and REPL.

oso is ideal for building permissions into user-facing applications, but you can check out Use Cases to learn about other applications for oso.

Using oso consists of two parts:

  1. Writing oso policies in a declarative policy language called Polar.
  2. Embedding oso in your application using the appropriate language-specific authorization library.

oso currently offers libraries for Java, Node.js, Python, Ruby, and Rust.

Getting started

To get up and running with oso, check out the Getting Started guides in the oso documentation.

Development

Core

oso's Rust core is developed against Rust's latest stable release.

Language libraries

oso's language libraries can be developed without touching the Rust core, but you will still need the Rust stable toolchain installed in order to build the core.

To build the WebAssembly core for the Node.js library, you will need to have wasm-pack installed and available on your system PATH.

Language requirements

To work on a language library, you will need to meet the following version requirements:

  • Java: 10+
    • Maven: 3.6+
  • Node.js: 10.14.2+
    • Yarn 1.22+
  • Python: 3.6+
  • Ruby: 2.4+
    • Bundler 2.1.4+
  • Rust: 1.46+

Contributing

See: CONTRIBUTING.md.

License

See: LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

oso-0.10.0-pp37-pypy37_pp73-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded PyPy manylinux: glibc 2.12+ x86-64

oso-0.10.0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded PyPy macOS 10.9+ x86-64

oso-0.10.0-pp36-pypy36_pp73-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded PyPy manylinux: glibc 2.12+ x86-64

oso-0.10.0-pp36-pypy36_pp73-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded PyPy macOS 10.9+ x86-64

oso-0.10.0-cp39-cp39-win_amd64.whl (615.0 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

oso-0.10.0-cp39-cp39-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.12+ x86-64

oso-0.10.0-cp39-cp39-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

oso-0.10.0-cp38-cp38-win_amd64.whl (615.0 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

oso-0.10.0-cp38-cp38-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64

oso-0.10.0-cp38-cp38-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

oso-0.10.0-cp37-cp37m-win_amd64.whl (615.0 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

oso-0.10.0-cp37-cp37m-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

oso-0.10.0-cp37-cp37m-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.7m macOS 10.9+ x86-64

oso-0.10.0-cp36-cp36m-win_amd64.whl (615.0 kB view hashes)

Uploaded CPython 3.6m Windows x86-64

oso-0.10.0-cp36-cp36m-manylinux2010_x86_64.whl (6.9 MB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

oso-0.10.0-cp36-cp36m-macosx_10_9_x86_64.whl (1.7 MB view hashes)

Uploaded CPython 3.6m macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page