Release notes

Release notes 2020

September 14, 2020 - Bosch IoT Things - service update

  • New - Implicit provisioning
    The new feature facilitates to register devices communicating via a gateway device “on-the-fly”. The gateways - acting on behalf of the devices - need to be configured with auto-provisioning-enabled, and to trigger implicit device registration by sending a telemetry or event message to the Bosch IoT Hub service. Afterwards the digital twin is created in the Bosch IoT Things service based on the provided template.

    The new configuration for the Hub-Things connection can be enabled and customized either via the HTTP API or via the Things UI.

    The default configuration for a Hub-Things connection will create

At this occasion, various minor bugs have also been fixed.

August 27, 2020 - Bosch IoT Things - service update

  • New top-level _created field for new things and policies
    In order to look up the time when a thing and its policy has been created, we have introduced a new field named _created. This field is set at provisioning time, and cannot be changed with PUT requests.
    However, the creation time is indexed for search request, and can be also used whenever you define a filter, e.g. get things, event filtering, etc.
    Example:
    List all things which have been created after August 31, 2020. The result should contain the thing IDs and the timestamps of their creation.
    /search/things?filter=gt(_created,"2020-08-31")&fields=thingId,_created
    A migration for old things (missing this field) is not implemented, thus only new things and their policies will benefit from this new field.

  • End-to-end acknowledge handling for the live channel
    Support for acknowledgements and acknowledgement requests are added to the live channel. All live commands and live messages may request acknowledgements. Find details at Acknowledgements.
    Note: The live-response acknowledgement is requested for live commands and live messages by default. If you wish to send them in a fire-and-forget manner via Bosch IoT Hub, please set the header response-required to false or disable acknowledgements for the connection source. Otherwise, the connection will keep requesting redelivery from Bosch IoT Hub.

  • Eclipse Ditto 1.2.0
    Our open source project will officially release version 1.2.0 on Aug 31, 2020.
    Find out what’s new at https://projects.eclipse.org/projects/iot.ditto/releases/1.2.0

At this occasion, various minor bugs have also been fixed.

July 30, 2020 - Bosch IoT Things - service update

  • End-to-end acknowledge handling for connectivity
    To make sure that a message is reported as delivered, or a change is confirmed as applied, only if other layers also confirm the success, you can request an acknowledgement (ACK).
    By requesting an ACK you can work on delivery guarantees or simply make sure the aim of your request is accomplished. Examples:
    • postpone a response to an API request (e.g. block an HTTP requestAcknowledgements) until one or more specific actions were performed in the Things service (e.g. a modification was successfully persisted).
    • postpone a response until an external subscriber connected to Things reports that he successfully processed an event which e.g. resulted by a persistence change in the Things service.
      Find details at Acknowledgements
      Note: As of now, the ACK is implemented for the twin channel only. The live channel does not support this concept yet.

  • Extended Free plan of Bosch IoT Things service
    New subscribers of our Free plan can kick-off even faster with evaluating their usage scenarios. Deviating from the regular 100,000 transactions per month, which are within the Free plan quota limits, for the first month after subscription we allow 1,000,000 transactions. However, a limitation to the the regular 100,000 transactions per month will be enforced after that period. Happy hacking.

  • Some special characters allowed in thing ID and policy ID
    The Device Provisioning API has introduced support for more characters in the thing ID and policy ID of your digital twin.
    While in previous versions, the Bosch IoT Things needed to restrict using special characters in IDs and keys, which might be part of the URL when requesting the thing, the latest service update comes with some relaxing news.
    The current, still valid restrictions for thing ID and policy ID at a glance:
    • must be unique and follow the pattern namespace:name
    • max. 256 characters
    • may not contain the slash character /
    • may not contain the control characters hex 00-1F to 7F-FF
    • may contain special characters, but these have to be encoded/decoded according to the standard/format required for the respective communication channel
      See Device provisioning examples in Asset Communication documentation.

  • Single quotes in RQL for quoting Strings
    Ditto brings in new support for single quotes in filters. When you already have to provide a query, e.g. as Java quoted String, it is easier and more readable to use single quotes instead of double quotes.
    Now, your query may look like this: eq(attributes/foo,'bar').

At this occasion, various minor bugs have also been fixed.

July 8, 2020 - Bosch IoT Things - service update

At this occasion, various minor bugs have also been fixed.

June 2, 2020 - Bosch IoT Things - service update

  • The Device Provisioning API has been enlarged
    • Using the new field authScope allows to choose that provisioning is done in the context of your subscription (i.e. service instance) instead of provisioning in context of the current requester, which is still the default. This will make sure that the created things will be accessible for all users who have access to the same Bosch IoT Suite subscription.
      See API docs > Bosch IoT Suite - Device Provisioning
    • It additionally provides a new endpoint for hybrid scenarios
      https://deviceprovisioning.eu-h1.bosch-iot-suite.com/api/1
      See Hybrid offering on Microsoft Azure
  • Further improvements
    • The Things dashboard uses Suite Auth (based on OAuth JWT tokens) for login and access control.
      Henceforth, you will not need to add further user IDs/special client IDs into the subject fields of your policies if you just want to use subscription/service instance level access control.
    • Details on the procedure how to “bring your own OAuth provider” have been published. See FAQ > How to configure a custom OAuth2 authorization provider?
  • Deprecations of authentication mechanisms
    • As the Bosch IoT Permissions service can not be booked for new customers, we have adjusted all examples, and deprecate the Basic authentication as well as JWT authentication with Bosch IoT Permissions as an issuer.
    • Additionally, in favor to the new Suite OAuth approach, we deprecate the Things specific API Token.

At this occasion, various minor bugs have also been fixed.

May 7, 2020 - Bosch IoT Things - service update

As the Things service is powered by Eclipse Ditto, you can benefit from all new features and improvements which come with Eclipse Ditto 1.1.0 :

  • New - Policy management and Search are now also supported via Ditto Protocol, and Java client.
  • CORS improvements and content-type restrictions
    As already announced to some of our customers, the Bosch IoT Things service will handle the content-type on all HTTP API calls more restrictively.
    • As our main content type for managing things and policies (as well as all their sub-structures) is application/json, please make sure, your requests use that content type.
    • The “Messages” resources are not affected, as for messages arbitrary content types might be required.
    • Resources without request content, e.g. GET endpoints, are also not affected.
    • The OPTIONS “preflight” request, required by CORS, is supported by the Bosch IoT Things service.
    • Further, we now additionally allow etag, if-match and if-none-match header in CORS requests and responses
  • Improved command reply-to for edge devices
    Edge devices, which have been registered via the Bosch IoT Gateway Software stack, usually do not have an explicit device ID at the Bosch IoT Hub service. Therefore, in such cases, the reply-to is now directed to the gateway.
  • Improved Free plan
    As customers of free plans reported that they run out of transactions too quickly at a very early stage, when they explore our service for the first time, we are happy to announce that henceforth, the free plan will contain the full transaction quota for first month, regardless on which day of the month the booking succeeded.
  • Improved handling of headers
    Due to security considerations, custom HTTP headers of incoming requests are no longer sent back in the HTTP response.

At this occasion, various minor bugs have also been fixed.

February 17, 2020 - Bosch IoT Things - service update

The new service release comes with various changes, as for example:

  • New - Enrichment of events and messages
    Subscribers of events and messages may request that the payload they receive is enriched with data from the related digital twin.
    This way, you can add e.g. attributes or feature properties of your things, which are not included in the original payload, but are helpful for your consumers.
    The selection of information to be added is defined using the parameter extraFields, which could point to one or multiple JSON fields of the things. Find details at Enrichment of events and messages.
  • Bosch IoT Things - various deprecations.
    The deprecated parts are still supported. As soon as we drop support we will announce it here.

At this occasion, various minor bugs have also been fixed.

January 30, 2020 - Bosch IoT Things - service update

The new service release comes with various changes, as for example:

At this occasion, various minor bugs have also been fixed.

January 10, 2020 - Bosch IoT Things - service update

Our first service release in 2020 comes with this change:

  • Chart view in Things Dashboard
    The Things Dashboard includes a chart view for viewing Thing property data collected over the time. This view helps to understand IoT device sensor data during the development of IoT solutions. The shown data is live data updated in Thing properties and is only collected during the time when the dashboard view is open. The data series is not stored.
    To open the view, go to the Things Dashboard into the Things list and click on a Thing entry. In the Thing view you can choose to switch to the chart view.

Archive

Archive 2019

2019

Archive 2018

2018

Archive 2017

2017

Archive 2016

2016

Archive 2015

2015

Imprint Legal info Privacy statement