Similar to our philosophy regarding database backends and the overall authentication scheme, authorization is also implemented in a pluggable fashion.
This means you can chose the plugin that fits your use case best. If you have only a few users and don’t need to differentiate between their rights, the
Admin List plugin is a perfect fit. If you need to control each user’s permissions at a very fine-grained level however, you should opt to use the
Admin List relies on the configured
Authentication Scheme to correctly identify the user. On each request a check against a pre-configured admin list is done. If the user is contained on this list, they get all permissions. If they aren’t they get none. It’s not possible to assign only some rights to a specific user with the Admin List plugin.
Other than a list of admins, it is also possible to specify a list of read-only users. Those users have permissions on all
list operations, but no other permissions.
If a subject is present on both the admin and read-only list, Weaviate will error on startup due to the invalid configuration.
Simply configure the admin plugin in the config yaml like so:
authorization: admin_list: enabled: true users: - email@example.com - firstname.lastname@example.org read_only_users: - email@example.com
The above would enable the plugin and make users
firstname.lastname@example.org admins. Aadditionally, user
email@example.com will have read-only permissions.
Note that in the above example email ids are used to identify the user. This is not a requirement, in fact, any string can be used. This depends on what you configured in the authentication settings. For example, if you are using Open ID Connect authentication, you could set the
More fine-grained Role-Based Access Control (RBAC) coming soon. As of know the only possible distinction is between Admins (CRUD), Read-Only Users and entirely unauthorized users.
Frequently Asked Questions
If you can’t find the answer to your question here, please use the: