OAuth2 client

An OAuth2 client is created and managed in Rollouts Management UI. It grants access to resources within the tenant's scope. The client consists of a client IDa secret, and a scope. This information is provided as configured into a client application. The client application uses the client to get a token from the Rollouts IdP authorization token endpoint.

Authorization token endpoint

The endpoint (URL) to request authorization tokens. The tokens can be requested according to the OAuth 2 spec RFC 6749. See https://oauth.net/2/.
At the time of writing, we support only the Client Credentials grant.

Authorization token

The Bearer token is issued by the Rollouts IdP - authorization token endpoint. The token authorizes access to service APIs.

Action

Requested operations for the targets. Usually, a software update. Other supported actions include canceling a running update action or refreshing target attributes.

Action Status

Status information of an action that can be provided by the target. This can be the start of the action lifecycle, the end, or update notifications in between.

Artifact

An Artifact is a file of any type that has been uploaded to Rollouts. It may contain firmware, an application, or a link to external artifact references.

Auto Assignment

Targets that match a Target Filter get a Distribution Set automatically assigned.

Controller

Term used in DDI API for a Target.

Device Management Federation API (DMF API)

AMQP-based API for indirect device integration via an external device management

Direct Device Integration API (DDI API)

Polling-based HTTP API for integrating devices

Distribution Set (DS)

A Distribution Set defines a meta package that combines a set of software modules that must be provisioned in their entirety (e.g., OS X Ver X, JVM Y ver. Y, AH Z ver. Z).

Distribution Set Type

A Distribution Set Type is an abstract definition for DS that defines which types of Software Modules can be added (optionally or mandatorily). A DS is considered complete if all mandatory Software Modules are present. Only a complete DS can be assigned to a Target.

Gateway

A device that indirectly connects other devices with Rollouts.

Gateway Security Token

Security Token of a Gateway to authenticate multiple targets (which are behind that Gateway) with Rollouts.

Management UI

The management UI of Bosch IoT Rollouts includes the following UI features: Actions, Targets, Rollouts, Software modules, and Distribution sets.
Available at https://console.eu1.bosch-iot-rollouts.com for EU1 users and https://console.us1.bosch-iot-rollouts.comfor US1 users.

Metadata

Metadata is key-value pairs that can be freely modified to describe and identify DSs and SMs.

Rollout

Software update on (a large set of) devices in a managed and defined way.

Security Token

A 32-character alphanumeric security token. Can either be a Gateway Security Token or a Target Token.

Software Module (SM)

A Software Module is a logical grouping of Artifacts based on a defined Software Module Type.

Software Module Type

A Software Module Type is an abstract definition for an SM that defines whether it is Firmware or Software. A DS can only be assigned to one SM of type Firmware, but multiple of type Software.

Tag

Tags are strings used to describe and identify Targets and DSs.

Target

A target is a device to which software can be assigned. (a.k.a. Controller)

Target Attributes

Attributes are key-value metadata sent by a target and stored on the Rollouts server. On the server side, they can be used to identify and classify targets based on their properties, e.g., hardware revision and serial number.

Target Filter

Filter targets by a defined query. Target Filters are used for Auto Assignments or to select targets for a Rollout.

Target Token

Security Token of a Target to authenticate with Rollouts.

Target Type

A Target Type is an abstract definition for Targets. It contains a list of Distribution Set Types that define if a Distribution Set is compatible with a Target.