Contents

Commands

vakna net allow

Note
This page is generated from a mock CLI, and its numbers are placeholders.

Verified against vakna 0.0.0-mock on · generated from the CLI's own definitions

vakna net allow: let boxes reach a host through Vakna's proxy; egress is in lockdown. Proposed: the real CLI doesn't have this command yet.

Synopsis

sh
vakna net allow <host>

Flags

Flag Default What it does
--format <format> text text, or json: one JSON object per line
--json off the same as --format json
-h, --help off this help

Examples

Example

sh
vakna net allow pypi.org
prints lockdown now lets pypi.org out · 3 hosts allowed 0.04s

Exit code 0.

Another example

sh
vakna net allow proxy.golang.org --format json
prints {"v":1,"event":"net_allowed","host":"proxy.golang.org","posture":"lockdown","allowed":["github.com","registry.npmjs.org","proxy.golang.org"],"ms":40,"mocked":true}

Exit code 0.

When it fails

sh
vakna net allow
prints vakna: missing a host hint: vakna net allow --help

Exit code 2.

Exit codes

Code Meaning
0 ok
2 usage: a missing argument, an unknown flag or command

JSON output

With --format json (or --json) every line is one JSON object. v is the format's version; mocked marks numbers from the mock.

sh
vakna net allow proxy.golang.org --format json
prints {"v":1,"event":"net_allowed","host":"proxy.golang.org","posture":"lockdown","allowed":["github.com","registry.npmjs.org","proxy.golang.org"],"ms":40,"mocked":true}

Errors

--help

This page and the help text come from one definition.

Output
vakna net allow · let boxes reach a host through Vakna's proxy; egress is in lockdown Proposed: the real CLI doesn't have this command yet. usage vakna net allow <host> flags --format <format> text, or json: one JSON object per line (default: text) --json the same as --format json (default: off) -h, --help this help (default: off) examples vakna net allow pypi.org vakna net allow proxy.golang.org --format json exit codes 0 ok 2 usage: a missing argument, an unknown flag or command

View as Markdown