Skip to main content

Sandboxed Execution Environment

Project description

Source:

https://github.com/F-Secure/see

Documentation:

https://see.readthedocs.io

Download:

https://pypi.python.org/pypi/python-see

Build Status Documentation Status

Introduction

Sandboxed Execution Environment (SEE) is a framework for building test automation in secured Environments.

The Sandboxes, provided via libvirt, are customizable allowing high degree of flexibility. Different type of Hypervisors (Qemu, VirtualBox, LXC) can be employed to run the Test Environments.

Plugins can be added to a Test Environment which provides an Event mechanism synchronisation for their interaction. Users can enable and configure the plugins through a JSON configuration file.

Audience

SEE is for automating tests against unknown, dangerous or unstable software tracking its activity during the execution.

SEE is well suited for building modular test platforms or managing executable code with a good degree of isolation.

SEE allows to write sandboxed tests both for quick prototyping and for running on production environment.

Installation

SEE is available as Python package on the Python Package Index (PyPI).

It’s user’s responsibility to install and setup the hypervisors intended to be controlled with SEE and the possible dependencies and subsystems used by the selected image providers.

Please refer to the documentation to see how to setup and configure each hypervisor.

Supported hypervisors

SEE is build on top of libvirt’s APIs, therefore all hypervisors supported by libvirt can be controlled through SEE.

SEE comes with a basic support for QEMU, VirtualBox and LXC, to add more hypervisor or customize the basic ones see the code contained in see/context.

Image providers

SEE uses a system of pluggable providers to retrieve disk images from arbitrary sources and make them available to SEE.

SEE bundles providers for LibVirt storage pools and OpenStack Glance as well as a dummy provider implementation, to add more providers see the code contained in see/image_providers.

Principles

SEE is an event-driven, plugin-based sandbox provider for synchronous and asynchronous test flow control.

                                                                  +----------+
                                                                  |          |
                                                          +-------| SEE Hook |
                                                          |       |          |
                                                          |       +----------+
              +---------+-------+       +---------+       |       +----------+
              |                 |       |         |       |       |          |
User -------> | SEE Environment |-------| Sandbox |-------+-------| SEE Hook |
              |                 |       |         |       |       |          |
              +-----------------+       +---------+       |       +----------+
                                                          |       +----------+
                                                          |       |          |
                                                          +-------| SEE Hook |
                                                                  |          |
                                                                  +----------+

A SEE Environment encapsulates all the required resources acting as a handler for the User. The Sandbox is controlled by the Hooks which act as plugins, Hooks communicate and co-ordinate themselves through Events.

Each Hook has direct access to the Sandbox which exposes a simple API for it’s control and libvirt’s APIs for more fine grained control.

Project details


Download files

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

Source Distribution

python-see-1.3.7.tar.gz (49.5 kB view details)

Uploaded Source

Built Distribution

python_see-1.3.7-py2.py3-none-any.whl (42.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file python-see-1.3.7.tar.gz.

File metadata

  • Download URL: python-see-1.3.7.tar.gz
  • Upload date:
  • Size: 49.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.7

File hashes

Hashes for python-see-1.3.7.tar.gz
Algorithm Hash digest
SHA256 e83d42a7345fa47e7fb00ba6575ca8c861f86ee1b9724f0e897f9f7e189245a4
MD5 0e99071c0610c2d5d321c37fa85a29dc
BLAKE2b-256 c08350c4db2acb347fcd1b8a9c388accc0be982b47a3b078277f2e794998b838

See more details on using hashes here.

File details

Details for the file python_see-1.3.7-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_see-1.3.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 df4b90ecd8e516637fbcdd1a999475ddc8244cea1dcf77773b6f865649f96fcd
MD5 578ec8bf8acec8a88a988733a2a81a81
BLAKE2b-256 77a0a8a21e123da41dc7f849ad99671a20e07e1a0600f17576838f0829fd9a03

See more details on using hashes here.

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