Creating an Edge Router Policy
- New Edge Router Policy via UI
- New Edge Router Policy via CLI
- On the left side nav bar, click "Ziti Policies"
- It should already be selected, but if not, on the top nav bar, click "Edge Router Policies"
- In the top right corner of the screen click the "plus" image to add a new Edge Router Policy
- Choose a name for the Edge Router Policy, such as "My Edge Router Policy"
- Enter the edge routers you want to include in the policy
- Specific edge routers can be referenced by ID or name using
@
. For example, an edge router calledus-east-4
can be referenced using@us-east-4
. - Edge routers can be referenced by role attribute using
#
. For example, any edge router which has theus-seast
role attribute will be included if#us-east
is included in the edge routers roles list.
- Specific edge routers can be referenced by ID or name using
- Enter the identities you want to include in the policy
- Specific identities can be referenced by ID or name using
@
. For example, as identity calledjsmith-desktop
can be referenced using@jsmith-desktop
. - Identities can be referenced by role attribute using
#
. For example, any identity which has thesales
role attribute will be included if#sales
is included in the identities roles list.
- Specific identities can be referenced by ID or name using
- Specify the role semantic
- If you select
Has Any Role
then if you specify multiple roles then all entities which include any of the roles will be included. - If you select
Must Have All Roles
, then if you specify multiple roles then only entities which include all of the given roles will be included
- If you select
- Click save
To create an Edge Router Policy using the CLI issue the following commands.
ensure you are logged in with the CLI.
The
ziti
CLI will help you get a session from the controller's management API. You will be prompted to trust any new server certificates. Your session cache and trust store are managed by the CLI in your home directory.# implies https://localhost:1280
ziti edge login -u admin -p admin# implies https://
ziti edge login ziti.example.com:8441 -u admin -p adminCreate an edge router policy named
my-policy
which allows all identities to use all routers.ziti edge create edge-router-policy my-policy --identity-roles '#all' --edge-router-roles '#all'