hawkbit/docs/content/concepts/authorization.md

title, parent, weight

title	parent	weight
Authorization	Concepts	52

Authorization is handled separately for Direct Device Integration (DDI) API and Device Management Federation (DMF) API (where successful authentication includes full authorization) and Management API and UI which is based on Spring security authorities.

However, keep in mind that hawkBit does not offer an off the shelf authentication provider to leverage these permissions and the underlying multi user/tenant capabilities of hawkBit. Check out Spring security documentation for further information. In hawkBit SecurityAutoConfiguration is a good starting point for integration.

The default implementation is single user/tenant with basic auth and the logged in user is provided with all permissions. Additionally, the application properties may be configured for multiple static users; see Multiple Users for details.

DDI API

An authenticated target is permitted to:

• retrieve commands from the server
• provide feedback to the the server
• download artifacts that are assigned to it

A target might be permitted to download artifacts without authentication (if enabled, see above). Only the download can be permitted to disable the authentication. This can be used in scenarios where the artifacts itself are e.g. signed and secured.

Management API and UI

Multiple Users

hawkBit optionally supports configuring multiple static users through the application properties. In this case, the user and password Spring security properties are ignored. An example configuration is given below.

hawkbit.server.im.users[0].username=admin
hawkbit.server.im.users[0].password={noop}admin
hawkbit.server.im.users[0].firstname=Test
hawkbit.server.im.users[0].lastname=Admin
hawkbit.server.im.users[0].email=admin@test.de
hawkbit.server.im.users[0].permissions=ALL

hawkbit.server.im.users[1].username=test
hawkbit.server.im.users[1].password={noop}test
hawkbit.server.im.users[1].firstname=Test
hawkbit.server.im.users[1].lastname=Tester
hawkbit.server.im.users[1].email=test@tester.com
hawkbit.server.im.users[1].permissions=READ_TARGET,UPDATE_TARGET,CREATE_TARGET,DELETE_TARGET

A permissions value of ALL will provide that user with all possible permissions. Passwords need to be specified with the used password encoder in brackets. In this example, noop is used as the plaintext encoder. For production use, it is recommended to use a hash function designed for passwords such as bcrypt. See this blog post for more information on password encoders in Spring Security.

Delivered Permissions

• READ_/UPDATE_/CREATE_/DELETE_TARGETS for:

  • Target entities including metadata (that includes also the installed and assigned distribution sets)
  • Target tags
  • Target actions
  • Target registration rules
  • Bulk operations
  • Target filters

• READ_/UPDATE_/CREATE_/DELETE_REPOSITORY for:

  • Distribution sets
  • Software Modules
  • Artifacts
  • DS tags

• READ_TARGET_SECURITY_TOKEN

  • Permission to read the target security token. The security token is security concerned and should be protected.

• DOWNLOAD_REPOSITORY_ARTIFACT

  • Permission to download artifacts of a software module (Note: READ_REPOSITORY allows only to read the metadata).

• TENANT_CONFIGURATION

  • Permission to administrate the tenant settings.

• ROLLOUT_MANAGEMENT

  • Permission to provision targets through rollouts.

Permission Matrix for example uses cases that need more than one permission

Use Case	Needed permissions
Search targets by installed or assigned distribution set	READ_TARGET, READ_REPOSITORY
Assign DS to a target	READ_REPOSITORY, UPDATE_TARGET
Assign DS to target through a Rollout, i.e. Rollout creation and start	READ_REPOSITORY, UPDATE_TARGET, ROLLOUT_MANAGEMENT
Read Rollout status including its deployment groups	ROLLOUT_MANAGEMENT
Checks targets inside Rollout deployment group	READ_TARGET, ROLLOUT_MANAGEMENT

Device Management Federation API

The provided RabbitMQ vhost and user should be provided with the necessary permissions to send messages to hawkBit through the exchange and receive messages from it through the specified queue.