What is Vensim?

VenSim is a tool that simulates VENs in an Illumio PCE. It is a CLI that can be downloaded from GitHub.

What is Vensim as a Service (VaaS)?

VaaS creates demo environments as a service without needing to download and run the CLI tool. From the create page, you instruct VaaS to create a standard demo environment in a blank PCE or customize a Vensim environment by providing your own input files.

VaaS will activate agents, send heartbeats every 5 minutes, get policy every 15 seconds (frequency to simulate event service lightning bolts), and post traffic every 10 minutes.

VaaS API

The VaaS endpoint is /api/v1/instances and suppots GET to see all instances, POST to create new instances, and DELETE to delete an instance.

GET

The GET API can take three query parameters: name, name_contains, and owner_email.

POST

When using POST to create an instance, the JSON format should look like the following:

{
    "name": "test",
    "email": "brian.pitta@vaas-test.com",
    "owner_first_name": "Brian",
    "owner_last_name": "Pitta",
    "delete_pwd": "deletepassword",
    "management_server": "pce.domain.com:443",
    "user": "api_1...d",
    "password": "0...3",
    "org": "3"
    "skip_workloader": false,
    "southbound_api_version": 26,
    "clear_existing_policy_objects": true,
    "unpair_existing_vens": true,
    "files": {
        "vens.csv": "aGVhZGVyMSxoZWFkZXIyCmEsYgpjLGQKcGxlYXNlLHdvcms="
    }
}

The list of files keys includes:

• vens.csv
• processes.csv
• traffic.csv
• wklds.csv
• svcs.csv
• svcs_meta.csv
• labels.csv
• rulesets.csv
• rules.csv
• ad_groups.csv

The value in the key-value pair is the base64 encoded content of the file.

DELETE

When using DELETE method the payload should look like below:

{
    "name": "test",
    "delete_pwd": "deletepassword",
}

Questions?

Email brian.pitta@illumio.com