Manage roles

Who: JIMM controller admin

See also: Role

Preview an example workflow
# Create a role
jimmctl auth role add myrole

# Verify that the role has been created successfully:
jimmctl auth role list

# Give the role admin access to a model:
jimmctl auth relation add role-model-admin#assignee administrator [email protected]/foo

# Rename the role to better match its function:
jimmctl auth role rename model-admin

# Grant Alice access to the role
jimmctl auth relation add [email protected] assignee role-model-admin

# Verify that Alice's access to the role has been granted successfully:
jimmctl auth relation check [email protected] administrator [email protected]/foo

Add a role

To add a new role to your JIMM controller, use the auth role add command followed by the name you want to assign to the role. For example:

jimmctl auth role add model-admin

View all the current roles

To view all the current roles, run the auth role list command. For example:

jimmctl auth role list [options]

Manage an entity’s relation to a role

See Manage relations.

Manage a role’s relation to an entity

See Manage relations.

Rename a role

To rename a role, run the auth role rename command followed by the old name and the new name. For example:

jimmctl auth role rename model-admin model-writer

Remove a role

To remove a role from a JIMM controller, run the auth role remove command followed by the name of the role. For example:

jimmctl auth role remove model-admin