updated project site -- build no: 16 -- publish HMAC blogpost + Ditto 2.0 slidedeck

Signed-off-by: Eclipse Ditto Bot <ditto-bot@eclipse.org>
diff --git a/2.0/2017-11-10-welcome-to-ditto.html b/2.0/2017-11-10-welcome-to-ditto.html
index 8734d0a..edf8224 100644
--- a/2.0/2017-11-10-welcome-to-ditto.html
+++ b/2.0/2017-11-10-welcome-to-ditto.html
@@ -280,7 +280,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2017-12-18-milestone-announcement-010-M1.html b/2.0/2017-12-18-milestone-announcement-010-M1.html
index 8f4cc7b..972a971 100644
--- a/2.0/2017-12-18-milestone-announcement-010-M1.html
+++ b/2.0/2017-12-18-milestone-announcement-010-M1.html
@@ -284,7 +284,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-01-12-milestone-announcement-010-M3.html b/2.0/2018-01-12-milestone-announcement-010-M3.html
index 9e3b81d..3138630 100644
--- a/2.0/2018-01-12-milestone-announcement-010-M3.html
+++ b/2.0/2018-01-12-milestone-announcement-010-M3.html
@@ -303,7 +303,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html b/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html
index 5163985..3650641 100644
--- a/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -292,7 +292,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-02-07-milestone-announcement-020-M1.html b/2.0/2018-02-07-milestone-announcement-020-M1.html
index 2a1072c..4deb718 100644
--- a/2.0/2018-02-07-milestone-announcement-020-M1.html
+++ b/2.0/2018-02-07-milestone-announcement-020-M1.html
@@ -304,7 +304,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-02-08-feature-definition.html b/2.0/2018-02-08-feature-definition.html
index 3374e0a..6fbd39d 100644
--- a/2.0/2018-02-08-feature-definition.html
+++ b/2.0/2018-02-08-feature-definition.html
@@ -334,7 +334,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-04-25-connectivity-service.html b/2.0/2018-04-25-connectivity-service.html
index 1e1f8c2..9f1404d 100644
--- a/2.0/2018-04-25-connectivity-service.html
+++ b/2.0/2018-04-25-connectivity-service.html
@@ -348,7 +348,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-04-26-milestone-announcement-030-M1.html b/2.0/2018-04-26-milestone-announcement-030-M1.html
index e2a2f73..415de2c 100644
--- a/2.0/2018-04-26-milestone-announcement-030-M1.html
+++ b/2.0/2018-04-26-milestone-announcement-030-M1.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-05-02-connecting-ditto-hono.html b/2.0/2018-05-02-connecting-ditto-hono.html
index 2d241fa..b5a3f5d 100644
--- a/2.0/2018-05-02-connecting-ditto-hono.html
+++ b/2.0/2018-05-02-connecting-ditto-hono.html
@@ -1022,7 +1022,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-06-15-milestone-announcement-030-M2.html b/2.0/2018-06-15-milestone-announcement-030-M2.html
index 66505e1..9c52aea 100644
--- a/2.0/2018-06-15-milestone-announcement-030-M2.html
+++ b/2.0/2018-06-15-milestone-announcement-030-M2.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-08-14-milestone-announcement-080-M1.html b/2.0/2018-08-14-milestone-announcement-080-M1.html
index 4f01c22..09f4aaa 100644
--- a/2.0/2018-08-14-milestone-announcement-080-M1.html
+++ b/2.0/2018-08-14-milestone-announcement-080-M1.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-09-21-selective-push-notifications.html b/2.0/2018-09-21-selective-push-notifications.html
index 5b63497..eb01e18 100644
--- a/2.0/2018-09-21-selective-push-notifications.html
+++ b/2.0/2018-09-21-selective-push-notifications.html
@@ -500,7 +500,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-09-27-milestone-announcement-080-M2.html b/2.0/2018-09-27-milestone-announcement-080-M2.html
index ae28ffd..4ce47e2 100644
--- a/2.0/2018-09-27-milestone-announcement-080-M2.html
+++ b/2.0/2018-09-27-milestone-announcement-080-M2.html
@@ -302,7 +302,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-10-16-example-mqtt-bidirectional.html b/2.0/2018-10-16-example-mqtt-bidirectional.html
index ba7210b..37fcb95 100644
--- a/2.0/2018-10-16-example-mqtt-bidirectional.html
+++ b/2.0/2018-10-16-example-mqtt-bidirectional.html
@@ -308,7 +308,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-11-14-milestone-announcement-080-M3.html b/2.0/2018-11-14-milestone-announcement-080-M3.html
index 4d45e73..f62d754 100644
--- a/2.0/2018-11-14-milestone-announcement-080-M3.html
+++ b/2.0/2018-11-14-milestone-announcement-080-M3.html
@@ -301,7 +301,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-11-28-release-announcement-080.html b/2.0/2018-11-28-release-announcement-080.html
index 91338e6..ef5e20e 100644
--- a/2.0/2018-11-28-release-announcement-080.html
+++ b/2.0/2018-11-28-release-announcement-080.html
@@ -296,7 +296,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2018-12-05-example-command-and-control.html b/2.0/2018-12-05-example-command-and-control.html
index 4ba1098..34fb505 100644
--- a/2.0/2018-12-05-example-command-and-control.html
+++ b/2.0/2018-12-05-example-command-and-control.html
@@ -535,7 +535,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-03-13-kafka-connectivity.html b/2.0/2019-03-13-kafka-connectivity.html
index 5a2e357..888c35a 100644
--- a/2.0/2019-03-13-kafka-connectivity.html
+++ b/2.0/2019-03-13-kafka-connectivity.html
@@ -282,7 +282,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-03-28-milestone-announcement-090-M1.html b/2.0/2019-03-28-milestone-announcement-090-M1.html
index 731c39e..f3172d3 100644
--- a/2.0/2019-03-28-milestone-announcement-090-M1.html
+++ b/2.0/2019-03-28-milestone-announcement-090-M1.html
@@ -298,7 +298,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-04-29-milestone-announcement-090-M2.html b/2.0/2019-04-29-milestone-announcement-090-M2.html
index 45e53de..a03a342 100644
--- a/2.0/2019-04-29-milestone-announcement-090-M2.html
+++ b/2.0/2019-04-29-milestone-announcement-090-M2.html
@@ -296,7 +296,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-07-10-release-announcement-090.html b/2.0/2019-07-10-release-announcement-090.html
index e8cbe6c..2088c90 100644
--- a/2.0/2019-07-10-release-announcement-090.html
+++ b/2.0/2019-07-10-release-announcement-090.html
@@ -302,7 +302,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-08-28-openid-connect.html b/2.0/2019-08-28-openid-connect.html
index e04a4dc..459829e 100644
--- a/2.0/2019-08-28-openid-connect.html
+++ b/2.0/2019-08-28-openid-connect.html
@@ -348,7 +348,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-09-17-milestone-announcement-100-M1a.html b/2.0/2019-09-17-milestone-announcement-100-M1a.html
index 1c6a30a..f250509 100644
--- a/2.0/2019-09-17-milestone-announcement-100-M1a.html
+++ b/2.0/2019-09-17-milestone-announcement-100-M1a.html
@@ -299,7 +299,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-10-17-http-connectivity.html b/2.0/2019-10-17-http-connectivity.html
index 007c5ac..f463df2 100644
--- a/2.0/2019-10-17-http-connectivity.html
+++ b/2.0/2019-10-17-http-connectivity.html
@@ -307,7 +307,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-11-04-milestone-announcement-100-M2.html b/2.0/2019-11-04-milestone-announcement-100-M2.html
index cf6fbbe..55dd3ff 100644
--- a/2.0/2019-11-04-milestone-announcement-100-M2.html
+++ b/2.0/2019-11-04-milestone-announcement-100-M2.html
@@ -298,7 +298,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2019-12-12-release-announcement-100.html b/2.0/2019-12-12-release-announcement-100.html
index 7b881fb..02ccbad 100644
--- a/2.0/2019-12-12-release-announcement-100.html
+++ b/2.0/2019-12-12-release-announcement-100.html
@@ -347,7 +347,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html b/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html
index c7006c0..38ae9e8 100644
--- a/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -794,7 +794,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-04-29-release-announcement-110.html b/2.0/2020-04-29-release-announcement-110.html
index ba58482..3a2ef18 100644
--- a/2.0/2020-04-29-release-announcement-110.html
+++ b/2.0/2020-04-29-release-announcement-110.html
@@ -328,7 +328,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-08-31-release-announcement-120.html b/2.0/2020-08-31-release-announcement-120.html
index b727855..23672bf 100644
--- a/2.0/2020-08-31-release-announcement-120.html
+++ b/2.0/2020-08-31-release-announcement-120.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-09-30-release-announcement-130.html b/2.0/2020-09-30-release-announcement-130.html
index 378a8b2..76bc692 100644
--- a/2.0/2020-09-30-release-announcement-130.html
+++ b/2.0/2020-09-30-release-announcement-130.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-10-08-asynchronous-client-creation.html b/2.0/2020-10-08-asynchronous-client-creation.html
index 86aa672..2cb51ad 100644
--- a/2.0/2020-10-08-asynchronous-client-creation.html
+++ b/2.0/2020-10-08-asynchronous-client-creation.html
@@ -340,7 +340,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-10-23-end-2-end-acknowledgment.html b/2.0/2020-10-23-end-2-end-acknowledgment.html
index e6020bb..3b9fd61 100644
--- a/2.0/2020-10-23-end-2-end-acknowledgment.html
+++ b/2.0/2020-10-23-end-2-end-acknowledgment.html
@@ -581,7 +581,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-10-28-release-announcement-140.html b/2.0/2020-10-28-release-announcement-140.html
index 6968b04..52441aa 100644
--- a/2.0/2020-10-28-release-announcement-140.html
+++ b/2.0/2020-10-28-release-announcement-140.html
@@ -304,7 +304,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-11-11-desired-properties.html b/2.0/2020-11-11-desired-properties.html
index 1a2503a..9004581 100644
--- a/2.0/2020-11-11-desired-properties.html
+++ b/2.0/2020-11-11-desired-properties.html
@@ -408,7 +408,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-11-16-weak-acknowledgements.html b/2.0/2020-11-16-weak-acknowledgements.html
index e7a6b82..bc4f34c 100644
--- a/2.0/2020-11-16-weak-acknowledgements.html
+++ b/2.0/2020-11-16-weak-acknowledgements.html
@@ -365,7 +365,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2020-12-10-release-announcement-150.html b/2.0/2020-12-10-release-announcement-150.html
index d6282a9..1028048 100644
--- a/2.0/2020-12-10-release-announcement-150.html
+++ b/2.0/2020-12-10-release-announcement-150.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2021-01-22-policy-subject-activate-token-integration.html b/2.0/2021-01-22-policy-subject-activate-token-integration.html
index 2adfef4..2d87c13 100644
--- a/2.0/2021-01-22-policy-subject-activate-token-integration.html
+++ b/2.0/2021-01-22-policy-subject-activate-token-integration.html
@@ -465,7 +465,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2021-02-04-merge-feature.html b/2.0/2021-02-04-merge-feature.html
index 3c7af93..601215f 100644
--- a/2.0/2021-02-04-merge-feature.html
+++ b/2.0/2021-02-04-merge-feature.html
@@ -604,7 +604,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2021-03-22-azure-iot-hub-integration.html b/2.0/2021-03-22-azure-iot-hub-integration.html
index 344f623..b419416 100644
--- a/2.0/2021-03-22-azure-iot-hub-integration.html
+++ b/2.0/2021-03-22-azure-iot-hub-integration.html
@@ -521,7 +521,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html b/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html
index 03770d6..4bf66b0 100644
--- a/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html
+++ b/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html
@@ -382,7 +382,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2021-05-06-release-announcement-200.html b/2.0/2021-05-06-release-announcement-200.html
index 97d5651..60b18b4 100644
--- a/2.0/2021-05-06-release-announcement-200.html
+++ b/2.0/2021-05-06-release-announcement-200.html
@@ -343,7 +343,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/404.html b/2.0/404.html
index 6d4ec89..de1b693 100644
--- a/2.0/404.html
+++ b/2.0/404.html
@@ -1750,7 +1750,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/advanced-data-by-pass.html b/2.0/advanced-data-by-pass.html
index ebec708..f37e458 100644
--- a/2.0/advanced-data-by-pass.html
+++ b/2.0/advanced-data-by-pass.html
@@ -1891,7 +1891,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-overview.html b/2.0/architecture-overview.html
index c11c4d1..58d2d5e 100644
--- a/2.0/architecture-overview.html
+++ b/2.0/architecture-overview.html
@@ -1803,7 +1803,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-concierge.html b/2.0/architecture-services-concierge.html
index 8663e1f..4972fb2 100644
--- a/2.0/architecture-services-concierge.html
+++ b/2.0/architecture-services-concierge.html
@@ -1789,7 +1789,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-connectivity.html b/2.0/architecture-services-connectivity.html
index 7fe5e7f..174bcbb 100644
--- a/2.0/architecture-services-connectivity.html
+++ b/2.0/architecture-services-connectivity.html
@@ -1803,7 +1803,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-gateway.html b/2.0/architecture-services-gateway.html
index 886644f..5b3a90d 100644
--- a/2.0/architecture-services-gateway.html
+++ b/2.0/architecture-services-gateway.html
@@ -1782,7 +1782,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-policies.html b/2.0/architecture-services-policies.html
index da49e64..21fdcbb 100644
--- a/2.0/architecture-services-policies.html
+++ b/2.0/architecture-services-policies.html
@@ -1782,7 +1782,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-things-search.html b/2.0/architecture-services-things-search.html
index 572df43..7e1d93d 100644
--- a/2.0/architecture-services-things-search.html
+++ b/2.0/architecture-services-things-search.html
@@ -1826,7 +1826,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/architecture-services-things.html b/2.0/architecture-services-things.html
index cbcbd51..c31fb08 100644
--- a/2.0/architecture-services-things.html
+++ b/2.0/architecture-services-things.html
@@ -1782,7 +1782,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-acknowledgements.html b/2.0/basic-acknowledgements.html
index cae848f..0b389fa 100644
--- a/2.0/basic-acknowledgements.html
+++ b/2.0/basic-acknowledgements.html
@@ -2419,7 +2419,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-apis.html b/2.0/basic-apis.html
index 326d469..2e410eb 100644
--- a/2.0/basic-apis.html
+++ b/2.0/basic-apis.html
@@ -1873,7 +1873,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-auth.html b/2.0/basic-auth.html
index c7667f7..fe203f5 100644
--- a/2.0/basic-auth.html
+++ b/2.0/basic-auth.html
@@ -1835,7 +1835,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-changenotifications.html b/2.0/basic-changenotifications.html
index b175efc..7234a28 100644
--- a/2.0/basic-changenotifications.html
+++ b/2.0/basic-changenotifications.html
@@ -1822,7 +1822,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-connections.html b/2.0/basic-connections.html
index 91f3a8b..ffeebce 100644
--- a/2.0/basic-connections.html
+++ b/2.0/basic-connections.html
@@ -2366,7 +2366,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-enrichment.html b/2.0/basic-enrichment.html
index 2a1ce4c..02f7257 100644
--- a/2.0/basic-enrichment.html
+++ b/2.0/basic-enrichment.html
@@ -1853,7 +1853,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-errors.html b/2.0/basic-errors.html
index 9395ea1..32dbc8c 100644
--- a/2.0/basic-errors.html
+++ b/2.0/basic-errors.html
@@ -1824,7 +1824,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-feature.html b/2.0/basic-feature.html
index caffd74..6adba63 100644
--- a/2.0/basic-feature.html
+++ b/2.0/basic-feature.html
@@ -2003,7 +2003,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-messages.html b/2.0/basic-messages.html
index c96519a..9b9886c 100644
--- a/2.0/basic-messages.html
+++ b/2.0/basic-messages.html
@@ -1881,7 +1881,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-metadata.html b/2.0/basic-metadata.html
index db0a12a..b3bc919 100644
--- a/2.0/basic-metadata.html
+++ b/2.0/basic-metadata.html
@@ -1939,7 +1939,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-namespaces-and-names.html b/2.0/basic-namespaces-and-names.html
index b676844..dbcac81 100644
--- a/2.0/basic-namespaces-and-names.html
+++ b/2.0/basic-namespaces-and-names.html
@@ -1827,7 +1827,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-overview.html b/2.0/basic-overview.html
index 0a3ae6e..31d852a 100644
--- a/2.0/basic-overview.html
+++ b/2.0/basic-overview.html
@@ -1807,7 +1807,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-placeholders.html b/2.0/basic-placeholders.html
index b32a4b2..6e4095e 100644
--- a/2.0/basic-placeholders.html
+++ b/2.0/basic-placeholders.html
@@ -2069,7 +2069,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-policy.html b/2.0/basic-policy.html
index 0666c64..723178c 100644
--- a/2.0/basic-policy.html
+++ b/2.0/basic-policy.html
@@ -2333,7 +2333,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-rql.html b/2.0/basic-rql.html
index 27cc6cb..29b0810 100644
--- a/2.0/basic-rql.html
+++ b/2.0/basic-rql.html
@@ -2002,7 +2002,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-search.html b/2.0/basic-search.html
index ff3bcf7..cd7091e 100644
--- a/2.0/basic-search.html
+++ b/2.0/basic-search.html
@@ -1902,7 +1902,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals-announcement.html b/2.0/basic-signals-announcement.html
index de5a049..4316a1b 100644
--- a/2.0/basic-signals-announcement.html
+++ b/2.0/basic-signals-announcement.html
@@ -1765,7 +1765,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals-command.html b/2.0/basic-signals-command.html
index 096bea1..056f416 100644
--- a/2.0/basic-signals-command.html
+++ b/2.0/basic-signals-command.html
@@ -1781,7 +1781,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals-commandresponse.html b/2.0/basic-signals-commandresponse.html
index 8ba3619..39cbe13 100644
--- a/2.0/basic-signals-commandresponse.html
+++ b/2.0/basic-signals-commandresponse.html
@@ -1760,7 +1760,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals-errorresponse.html b/2.0/basic-signals-errorresponse.html
index 4b0ede9..3d9b01b 100644
--- a/2.0/basic-signals-errorresponse.html
+++ b/2.0/basic-signals-errorresponse.html
@@ -1768,7 +1768,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals-event.html b/2.0/basic-signals-event.html
index 83d6c91..869d7b6 100644
--- a/2.0/basic-signals-event.html
+++ b/2.0/basic-signals-event.html
@@ -1767,7 +1767,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-signals.html b/2.0/basic-signals.html
index 69478b1..ab6f048 100644
--- a/2.0/basic-signals.html
+++ b/2.0/basic-signals.html
@@ -1812,7 +1812,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/basic-thing.html b/2.0/basic-thing.html
index 0586073..2b484b1 100644
--- a/2.0/basic-thing.html
+++ b/2.0/basic-thing.html
@@ -1846,7 +1846,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/blog.html b/2.0/blog.html
index a66f484..576d769 100644
--- a/2.0/blog.html
+++ b/2.0/blog.html
@@ -431,7 +431,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/blog_archive.html b/2.0/blog_archive.html
index 9cc2223..248b090 100644
--- a/2.0/blog_archive.html
+++ b/2.0/blog_archive.html
@@ -557,7 +557,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/client-sdk-java.html b/2.0/client-sdk-java.html
index 229bece..dfa5dc9 100644
--- a/2.0/client-sdk-java.html
+++ b/2.0/client-sdk-java.html
@@ -1816,7 +1816,7 @@
         <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Thing could not be created due to: "</span> <span class="o">+</span> <span class="n">throwable</span><span class="o">.</span><span class="na">getMessage</span><span class="o">());</span>
     <span class="o">}</span>
     <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">forId</span><span class="o">(</span><span class="n">thingId</span><span class="o">).</span><span class="na">putAttribute</span><span class="o">(</span><span class="s">"first-updated-at"</span><span class="o">,</span> <span class="n">OffsetDateTime</span><span class="o">.</span><span class="na">now</span><span class="o">().</span><span class="na">toString</span><span class="o">());</span>
-<span class="o">}).</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+<span class="o">}).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <h4 id="subscribe-for-change-notifications">Subscribe for change notifications</h4>
@@ -1824,7 +1824,7 @@
 <p>In order to subscribe for <a href="basic-signals-event.html">events</a> emitted by Ditto after a twin was modified, start the 
 consumption on the <code class="highlighter-rouge">twin</code> channel:</p>
 
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">get</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="k">if</span> <span class="o">(</span><span class="n">change</span><span class="o">.</span><span class="na">getAction</span><span class="o">()</span> <span class="o">==</span> <span class="n">ChangeAction</span><span class="o">.</span><span class="na">CREATED</span><span class="o">)</span> <span class="o">{</span>
@@ -1838,7 +1838,7 @@
 
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"gt(features/temperature/properties/value,23.0)"</span><span class="o">)</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForFeaturePropertyChanges</span><span class="o">(</span><span class="s">"my-feature-changes"</span><span class="o">,</span> <span class="s">"temperature"</span><span class="o">,</span> <span class="s">"value"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="c1">// perform custom actions ..</span>
@@ -1852,7 +1852,7 @@
 
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">))</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-enriched-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="n">Optional</span><span class="o">&lt;</span><span class="n">JsonObject</span><span class="o">&gt;</span> <span class="n">extra</span> <span class="o">=</span> <span class="n">change</span><span class="o">.</span><span class="na">getExtra</span><span class="o">();</span>
    <span class="c1">// perform custom actions, making use of the 'extra' data ..</span>
@@ -1864,7 +1864,7 @@
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">)),</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"eq(attributes/location,\"kitchen\")"</span><span class="o">)</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="c1">// register the callbacks...</span>
 </code></pre></div></div>
 
@@ -1872,7 +1872,9 @@
 
 <p>Register for receiving messages with the subject <code class="highlighter-rouge">hello.world</code> on any thing:</p>
 
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">registerForMessage</span><span class="o">(</span><span class="s">"globalMessageHandler"</span><span class="o">,</span> <span class="s">"hello.world"</span><span class="o">,</span> <span class="n">message</span> <span class="o">-&gt;</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for live messages/commands/events"</span><span class="o">);</span>
+<span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">registerForMessage</span><span class="o">(</span><span class="s">"globalMessageHandler"</span><span class="o">,</span> <span class="s">"hello.world"</span><span class="o">,</span> <span class="n">message</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Received Message with subject "</span> <span class="o">+</span>  <span class="n">message</span><span class="o">.</span><span class="na">getSubject</span><span class="o">());</span>
    <span class="n">message</span><span class="o">.</span><span class="na">reply</span><span class="o">()</span>
       <span class="o">.</span><span class="na">statusCode</span><span class="o">(</span><span class="n">HttpStatusCode</span><span class="o">.</span><span class="na">IM_A_TEAPOT</span><span class="o">)</span>
@@ -1897,7 +1899,7 @@
 
 <p>Read a policy:</p>
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Policy</span> <span class="n">retrievedPolicy</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">retrieve</span><span class="o">(</span><span class="n">PolicyId</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-policy"</span><span class="o">))</span>
-   <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+   <span class="o">.</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <p>Create a policy:</p>
@@ -1909,7 +1911,7 @@
    <span class="o">.</span><span class="na">build</span><span class="o">();</span>
 
 <span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">create</span><span class="o">(</span><span class="n">newPolicy</span><span class="o">)</span>
-   <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+   <span class="o">.</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <p>Updating and deleting policies is also possible via the Java client API, please follow the API and the JavaDoc.</p>
@@ -2004,7 +2006,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/client-sdk-javascript.html b/2.0/client-sdk-javascript.html
index a74a098..ec4ac65 100644
--- a/2.0/client-sdk-javascript.html
+++ b/2.0/client-sdk-javascript.html
@@ -1808,7 +1808,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/client-sdk-overview.html b/2.0/client-sdk-overview.html
index b564b95..002a285 100644
--- a/2.0/client-sdk-overview.html
+++ b/2.0/client-sdk-overview.html
@@ -1763,7 +1763,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-header-mapping.html b/2.0/connectivity-header-mapping.html
index 2fce4c5..fef886e 100644
--- a/2.0/connectivity-header-mapping.html
+++ b/2.0/connectivity-header-mapping.html
@@ -1773,7 +1773,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-manage-connections.html b/2.0/connectivity-manage-connections.html
index 7b788bd..af487b5 100644
--- a/2.0/connectivity-manage-connections.html
+++ b/2.0/connectivity-manage-connections.html
@@ -2104,7 +2104,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-mapping.html b/2.0/connectivity-mapping.html
index 61c84e2..05539b9 100644
--- a/2.0/connectivity-mapping.html
+++ b/2.0/connectivity-mapping.html
@@ -2701,7 +2701,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-overview.html b/2.0/connectivity-overview.html
index 124ecf6..8e8c2cd 100644
--- a/2.0/connectivity-overview.html
+++ b/2.0/connectivity-overview.html
@@ -1776,7 +1776,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-amqp091.html b/2.0/connectivity-protocol-bindings-amqp091.html
index 23b1e59..d2e336a 100644
--- a/2.0/connectivity-protocol-bindings-amqp091.html
+++ b/2.0/connectivity-protocol-bindings-amqp091.html
@@ -1921,7 +1921,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-amqp10.html b/2.0/connectivity-protocol-bindings-amqp10.html
index ee2bbe4..948a7dd 100644
--- a/2.0/connectivity-protocol-bindings-amqp10.html
+++ b/2.0/connectivity-protocol-bindings-amqp10.html
@@ -1967,7 +1967,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-http.html b/2.0/connectivity-protocol-bindings-http.html
index 075a2ec..16c83d0 100644
--- a/2.0/connectivity-protocol-bindings-http.html
+++ b/2.0/connectivity-protocol-bindings-http.html
@@ -1974,7 +1974,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-kafka2.html b/2.0/connectivity-protocol-bindings-kafka2.html
index d5175cf..daa0c63 100644
--- a/2.0/connectivity-protocol-bindings-kafka2.html
+++ b/2.0/connectivity-protocol-bindings-kafka2.html
@@ -1899,7 +1899,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-mqtt.html b/2.0/connectivity-protocol-bindings-mqtt.html
index dbadfa5..fef9d4e 100644
--- a/2.0/connectivity-protocol-bindings-mqtt.html
+++ b/2.0/connectivity-protocol-bindings-mqtt.html
@@ -2171,7 +2171,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-protocol-bindings-mqtt5.html b/2.0/connectivity-protocol-bindings-mqtt5.html
index c00c4e9..54c143d 100644
--- a/2.0/connectivity-protocol-bindings-mqtt5.html
+++ b/2.0/connectivity-protocol-bindings-mqtt5.html
@@ -2177,7 +2177,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-ssh-tunneling.html b/2.0/connectivity-ssh-tunneling.html
index c0b988f..098d4c5 100644
--- a/2.0/connectivity-ssh-tunneling.html
+++ b/2.0/connectivity-ssh-tunneling.html
@@ -1841,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/connectivity-tls-certificates.html b/2.0/connectivity-tls-certificates.html
index ece007c..2a39f4f 100644
--- a/2.0/connectivity-tls-certificates.html
+++ b/2.0/connectivity-tls-certificates.html
@@ -1871,7 +1871,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/feed.xml b/2.0/feed.xml
index f2650fe..9dea851 100644
--- a/2.0/feed.xml
+++ b/2.0/feed.xml
@@ -5,8 +5,8 @@
         <description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
         <link>https://www.eclipse.org/ditto/</link>
         <atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
-        <pubDate>Thu, 20 May 2021 11:43:34 +0000</pubDate>
-        <lastBuildDate>Thu, 20 May 2021 11:43:34 +0000</lastBuildDate>
+        <pubDate>Mon, 21 Jun 2021 15:45:10 +0000</pubDate>
+        <lastBuildDate>Mon, 21 Jun 2021 15:45:10 +0000</lastBuildDate>
         <generator>Jekyll v3.6.2</generator>
         
         <item>
diff --git a/2.0/feedback.html b/2.0/feedback.html
index f6c37a9..054eac9 100644
--- a/2.0/feedback.html
+++ b/2.0/feedback.html
@@ -1767,7 +1767,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/glossary.html b/2.0/glossary.html
index 1905744..90da9e4 100644
--- a/2.0/glossary.html
+++ b/2.0/glossary.html
@@ -1763,7 +1763,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/http-api-doc.html b/2.0/http-api-doc.html
index ffb2079..12c5010 100644
--- a/2.0/http-api-doc.html
+++ b/2.0/http-api-doc.html
@@ -219,7 +219,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-concepts.html b/2.0/httpapi-concepts.html
index ed3a681..2ef4261 100644
--- a/2.0/httpapi-concepts.html
+++ b/2.0/httpapi-concepts.html
@@ -2397,7 +2397,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-messages.html b/2.0/httpapi-messages.html
index ee103ed..58c030c 100644
--- a/2.0/httpapi-messages.html
+++ b/2.0/httpapi-messages.html
@@ -1851,7 +1851,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-overview.html b/2.0/httpapi-overview.html
index f4eeefb..45c77ef 100644
--- a/2.0/httpapi-overview.html
+++ b/2.0/httpapi-overview.html
@@ -1772,7 +1772,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-protocol-bindings-cloudevents.html b/2.0/httpapi-protocol-bindings-cloudevents.html
index fef9667..aeea1e3 100644
--- a/2.0/httpapi-protocol-bindings-cloudevents.html
+++ b/2.0/httpapi-protocol-bindings-cloudevents.html
@@ -1857,7 +1857,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-protocol-bindings-websocket.html b/2.0/httpapi-protocol-bindings-websocket.html
index 4f4959c..1a1cf30 100644
--- a/2.0/httpapi-protocol-bindings-websocket.html
+++ b/2.0/httpapi-protocol-bindings-websocket.html
@@ -2101,7 +2101,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-search.html b/2.0/httpapi-search.html
index 04bad7f..b8853dd 100644
--- a/2.0/httpapi-search.html
+++ b/2.0/httpapi-search.html
@@ -1819,7 +1819,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/httpapi-sse.html b/2.0/httpapi-sse.html
index 9c99e8d..6fb30f1 100644
--- a/2.0/httpapi-sse.html
+++ b/2.0/httpapi-sse.html
@@ -2005,7 +2005,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/index.html b/2.0/index.html
index 8fa64af..f45c3e3 100644
--- a/2.0/index.html
+++ b/2.0/index.html
@@ -281,7 +281,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/installation-building.html b/2.0/installation-building.html
index d8e89fd..588f4bd 100644
--- a/2.0/installation-building.html
+++ b/2.0/installation-building.html
@@ -1790,7 +1790,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/installation-operating.html b/2.0/installation-operating.html
index 0256f95..5e47691 100644
--- a/2.0/installation-operating.html
+++ b/2.0/installation-operating.html
@@ -2703,7 +2703,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/installation-running.html b/2.0/installation-running.html
index 9a99192..e30664f 100644
--- a/2.0/installation-running.html
+++ b/2.0/installation-running.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/intro-digitaltwins.html b/2.0/intro-digitaltwins.html
index fd0a1bb..2c75fcd 100644
--- a/2.0/intro-digitaltwins.html
+++ b/2.0/intro-digitaltwins.html
@@ -1793,7 +1793,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/intro-hello-world.html b/2.0/intro-hello-world.html
index 7fb1f59..1993196 100644
--- a/2.0/intro-hello-world.html
+++ b/2.0/intro-hello-world.html
@@ -1884,7 +1884,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/intro-overview.html b/2.0/intro-overview.html
index db91a6d..da74e53 100644
--- a/2.0/intro-overview.html
+++ b/2.0/intro-overview.html
@@ -1811,7 +1811,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/presentations.html b/2.0/presentations.html
index 0201a2e..f7959fe 100644
--- a/2.0/presentations.html
+++ b/2.0/presentations.html
@@ -1803,7 +1803,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-bindings.html b/2.0/protocol-bindings.html
index a0f2c8f..c543553 100644
--- a/2.0/protocol-bindings.html
+++ b/2.0/protocol-bindings.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createattribute.html b/2.0/protocol-examples-createattribute.html
index 0ee1c86..e5f844b 100644
--- a/2.0/protocol-examples-createattribute.html
+++ b/2.0/protocol-examples-createattribute.html
@@ -1791,7 +1791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createattributes.html b/2.0/protocol-examples-createattributes.html
index 09ce2d0..8ed5699 100644
--- a/2.0/protocol-examples-createattributes.html
+++ b/2.0/protocol-examples-createattributes.html
@@ -1796,7 +1796,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createdefinition.html b/2.0/protocol-examples-createdefinition.html
index 8bcc18c..c0b8d3c 100644
--- a/2.0/protocol-examples-createdefinition.html
+++ b/2.0/protocol-examples-createdefinition.html
@@ -1789,7 +1789,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createdesiredproperties.html b/2.0/protocol-examples-createdesiredproperties.html
index e80e903..0e15812 100644
--- a/2.0/protocol-examples-createdesiredproperties.html
+++ b/2.0/protocol-examples-createdesiredproperties.html
@@ -1794,7 +1794,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createdesiredproperty.html b/2.0/protocol-examples-createdesiredproperty.html
index 916b04d..94cd676 100644
--- a/2.0/protocol-examples-createdesiredproperty.html
+++ b/2.0/protocol-examples-createdesiredproperty.html
@@ -1784,7 +1784,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createfeature.html b/2.0/protocol-examples-createfeature.html
index e0b6ca7..37b0d16 100644
--- a/2.0/protocol-examples-createfeature.html
+++ b/2.0/protocol-examples-createfeature.html
@@ -1812,7 +1812,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createfeatures.html b/2.0/protocol-examples-createfeatures.html
index cb72f25..60851eb 100644
--- a/2.0/protocol-examples-createfeatures.html
+++ b/2.0/protocol-examples-createfeatures.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createproperties.html b/2.0/protocol-examples-createproperties.html
index 41139b4..891d208 100644
--- a/2.0/protocol-examples-createproperties.html
+++ b/2.0/protocol-examples-createproperties.html
@@ -1795,7 +1795,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createproperty.html b/2.0/protocol-examples-createproperty.html
index 1c6c645..ce39607 100644
--- a/2.0/protocol-examples-createproperty.html
+++ b/2.0/protocol-examples-createproperty.html
@@ -1785,7 +1785,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-creatething.html b/2.0/protocol-examples-creatething.html
index 7326604..00304a2 100644
--- a/2.0/protocol-examples-creatething.html
+++ b/2.0/protocol-examples-creatething.html
@@ -1900,7 +1900,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-createthingdefinition.html b/2.0/protocol-examples-createthingdefinition.html
index 362c5cd..caee7cb 100644
--- a/2.0/protocol-examples-createthingdefinition.html
+++ b/2.0/protocol-examples-createthingdefinition.html
@@ -1786,7 +1786,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deleteattribute.html b/2.0/protocol-examples-deleteattribute.html
index 59dea6f..c3b73ef 100644
--- a/2.0/protocol-examples-deleteattribute.html
+++ b/2.0/protocol-examples-deleteattribute.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deleteattributes.html b/2.0/protocol-examples-deleteattributes.html
index e90689e..81d7c56 100644
--- a/2.0/protocol-examples-deleteattributes.html
+++ b/2.0/protocol-examples-deleteattributes.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletedefinition.html b/2.0/protocol-examples-deletedefinition.html
index ee385c2..debaf9c 100644
--- a/2.0/protocol-examples-deletedefinition.html
+++ b/2.0/protocol-examples-deletedefinition.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletedesiredproperties.html b/2.0/protocol-examples-deletedesiredproperties.html
index baff6d8..75c9f5f 100644
--- a/2.0/protocol-examples-deletedesiredproperties.html
+++ b/2.0/protocol-examples-deletedesiredproperties.html
@@ -1782,7 +1782,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletedesiredproperty.html b/2.0/protocol-examples-deletedesiredproperty.html
index 27efac1..ffffd95 100644
--- a/2.0/protocol-examples-deletedesiredproperty.html
+++ b/2.0/protocol-examples-deletedesiredproperty.html
@@ -1782,7 +1782,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletefeature.html b/2.0/protocol-examples-deletefeature.html
index 7ef7890..92afa0b 100644
--- a/2.0/protocol-examples-deletefeature.html
+++ b/2.0/protocol-examples-deletefeature.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletefeatures.html b/2.0/protocol-examples-deletefeatures.html
index dc55124..b839072 100644
--- a/2.0/protocol-examples-deletefeatures.html
+++ b/2.0/protocol-examples-deletefeatures.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deleteproperties.html b/2.0/protocol-examples-deleteproperties.html
index 553ffe9..e720d75 100644
--- a/2.0/protocol-examples-deleteproperties.html
+++ b/2.0/protocol-examples-deleteproperties.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deleteproperty.html b/2.0/protocol-examples-deleteproperty.html
index 7d37969..084e1cf 100644
--- a/2.0/protocol-examples-deleteproperty.html
+++ b/2.0/protocol-examples-deleteproperty.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletething.html b/2.0/protocol-examples-deletething.html
index 67d121a..d97994f 100644
--- a/2.0/protocol-examples-deletething.html
+++ b/2.0/protocol-examples-deletething.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-deletethingdefinition.html b/2.0/protocol-examples-deletethingdefinition.html
index 2c939a0..83ec2b8 100644
--- a/2.0/protocol-examples-deletethingdefinition.html
+++ b/2.0/protocol-examples-deletethingdefinition.html
@@ -1783,7 +1783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-errorresponses.html b/2.0/protocol-examples-errorresponses.html
index 765f697..dce953c 100644
--- a/2.0/protocol-examples-errorresponses.html
+++ b/2.0/protocol-examples-errorresponses.html
@@ -2260,7 +2260,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergeattribute.html b/2.0/protocol-examples-mergeattribute.html
index 0f0579d..986e2db 100644
--- a/2.0/protocol-examples-mergeattribute.html
+++ b/2.0/protocol-examples-mergeattribute.html
@@ -1805,7 +1805,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergeattributes.html b/2.0/protocol-examples-mergeattributes.html
index 9409f11..9d52302 100644
--- a/2.0/protocol-examples-mergeattributes.html
+++ b/2.0/protocol-examples-mergeattributes.html
@@ -1809,7 +1809,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergedesiredproperties.html b/2.0/protocol-examples-mergedesiredproperties.html
index bf599c3..28af208 100644
--- a/2.0/protocol-examples-mergedesiredproperties.html
+++ b/2.0/protocol-examples-mergedesiredproperties.html
@@ -1809,7 +1809,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergedesiredproperty.html b/2.0/protocol-examples-mergedesiredproperty.html
index ede0c92..d6851d4 100644
--- a/2.0/protocol-examples-mergedesiredproperty.html
+++ b/2.0/protocol-examples-mergedesiredproperty.html
@@ -1799,7 +1799,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergefeature.html b/2.0/protocol-examples-mergefeature.html
index 63e0209..5ae0d49 100644
--- a/2.0/protocol-examples-mergefeature.html
+++ b/2.0/protocol-examples-mergefeature.html
@@ -1819,7 +1819,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergefeaturedefinition.html b/2.0/protocol-examples-mergefeaturedefinition.html
index 960f8ab..2f251ed 100644
--- a/2.0/protocol-examples-mergefeaturedefinition.html
+++ b/2.0/protocol-examples-mergefeaturedefinition.html
@@ -1803,7 +1803,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergefeatures.html b/2.0/protocol-examples-mergefeatures.html
index 7d97e2c..b36c09b 100644
--- a/2.0/protocol-examples-mergefeatures.html
+++ b/2.0/protocol-examples-mergefeatures.html
@@ -1823,7 +1823,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergepolicyid.html b/2.0/protocol-examples-mergepolicyid.html
index f26b1ba..1abcc2c 100644
--- a/2.0/protocol-examples-mergepolicyid.html
+++ b/2.0/protocol-examples-mergepolicyid.html
@@ -1786,7 +1786,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergeproperties.html b/2.0/protocol-examples-mergeproperties.html
index 8fa7590..4b713dc 100644
--- a/2.0/protocol-examples-mergeproperties.html
+++ b/2.0/protocol-examples-mergeproperties.html
@@ -1809,7 +1809,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergeproperty.html b/2.0/protocol-examples-mergeproperty.html
index 41ed03f..194d76b 100644
--- a/2.0/protocol-examples-mergeproperty.html
+++ b/2.0/protocol-examples-mergeproperty.html
@@ -1799,7 +1799,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergething.html b/2.0/protocol-examples-mergething.html
index b328021..6f558f7 100644
--- a/2.0/protocol-examples-mergething.html
+++ b/2.0/protocol-examples-mergething.html
@@ -1832,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-mergethingdefinition.html b/2.0/protocol-examples-mergethingdefinition.html
index e7fd82e..9fc8ac4 100644
--- a/2.0/protocol-examples-mergethingdefinition.html
+++ b/2.0/protocol-examples-mergethingdefinition.html
@@ -1799,7 +1799,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyattribute.html b/2.0/protocol-examples-modifyattribute.html
index df409c7..810b316 100644
--- a/2.0/protocol-examples-modifyattribute.html
+++ b/2.0/protocol-examples-modifyattribute.html
@@ -1791,7 +1791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyattributes.html b/2.0/protocol-examples-modifyattributes.html
index c846bce..d1a4fd2 100644
--- a/2.0/protocol-examples-modifyattributes.html
+++ b/2.0/protocol-examples-modifyattributes.html
@@ -1796,7 +1796,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifydefinition.html b/2.0/protocol-examples-modifydefinition.html
index e29aa3e..7d64a63 100644
--- a/2.0/protocol-examples-modifydefinition.html
+++ b/2.0/protocol-examples-modifydefinition.html
@@ -1789,7 +1789,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifydesiredproperties.html b/2.0/protocol-examples-modifydesiredproperties.html
index 5162976..3730cda 100644
--- a/2.0/protocol-examples-modifydesiredproperties.html
+++ b/2.0/protocol-examples-modifydesiredproperties.html
@@ -1794,7 +1794,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifydesiredproperty.html b/2.0/protocol-examples-modifydesiredproperty.html
index dee4ced..2fba3c6 100644
--- a/2.0/protocol-examples-modifydesiredproperty.html
+++ b/2.0/protocol-examples-modifydesiredproperty.html
@@ -1784,7 +1784,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyfeature.html b/2.0/protocol-examples-modifyfeature.html
index 3c42317..1c99777 100644
--- a/2.0/protocol-examples-modifyfeature.html
+++ b/2.0/protocol-examples-modifyfeature.html
@@ -1812,7 +1812,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyfeatures.html b/2.0/protocol-examples-modifyfeatures.html
index 7e9e254..fd766eb 100644
--- a/2.0/protocol-examples-modifyfeatures.html
+++ b/2.0/protocol-examples-modifyfeatures.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifypolicyid.html b/2.0/protocol-examples-modifypolicyid.html
index 5ec38aa..36c502c 100644
--- a/2.0/protocol-examples-modifypolicyid.html
+++ b/2.0/protocol-examples-modifypolicyid.html
@@ -1811,7 +1811,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyproperties.html b/2.0/protocol-examples-modifyproperties.html
index db7e0c2..1bfe165 100644
--- a/2.0/protocol-examples-modifyproperties.html
+++ b/2.0/protocol-examples-modifyproperties.html
@@ -1795,7 +1795,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifyproperty.html b/2.0/protocol-examples-modifyproperty.html
index 31fa863..af14429 100644
--- a/2.0/protocol-examples-modifyproperty.html
+++ b/2.0/protocol-examples-modifyproperty.html
@@ -1785,7 +1785,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifything.html b/2.0/protocol-examples-modifything.html
index c7ac2c3..901e7ac 100644
--- a/2.0/protocol-examples-modifything.html
+++ b/2.0/protocol-examples-modifything.html
@@ -1881,7 +1881,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-modifythingdefinition.html b/2.0/protocol-examples-modifythingdefinition.html
index a8afdc5..54caf49 100644
--- a/2.0/protocol-examples-modifythingdefinition.html
+++ b/2.0/protocol-examples-modifythingdefinition.html
@@ -1785,7 +1785,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-announcement-subjectDeletion.html b/2.0/protocol-examples-policies-announcement-subjectDeletion.html
index 2e0881c..fb0b7d9 100644
--- a/2.0/protocol-examples-policies-announcement-subjectDeletion.html
+++ b/2.0/protocol-examples-policies-announcement-subjectDeletion.html
@@ -1766,7 +1766,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-createpolicy.html b/2.0/protocol-examples-policies-createpolicy.html
index 5c7d445..c4ec428 100644
--- a/2.0/protocol-examples-policies-createpolicy.html
+++ b/2.0/protocol-examples-policies-createpolicy.html
@@ -1813,7 +1813,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-createpolicyentry.html b/2.0/protocol-examples-policies-createpolicyentry.html
index 1421a15..2598f86 100644
--- a/2.0/protocol-examples-policies-createpolicyentry.html
+++ b/2.0/protocol-examples-policies-createpolicyentry.html
@@ -1789,7 +1789,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-createresource.html b/2.0/protocol-examples-policies-createresource.html
index 9373427..61c68ca 100644
--- a/2.0/protocol-examples-policies-createresource.html
+++ b/2.0/protocol-examples-policies-createresource.html
@@ -1778,7 +1778,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-createsubject.html b/2.0/protocol-examples-policies-createsubject.html
index 8552cb4..9eaf87e 100644
--- a/2.0/protocol-examples-policies-createsubject.html
+++ b/2.0/protocol-examples-policies-createsubject.html
@@ -1774,7 +1774,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-deletepolicy.html b/2.0/protocol-examples-policies-deletepolicy.html
index 611a31b..fe24cd9 100644
--- a/2.0/protocol-examples-policies-deletepolicy.html
+++ b/2.0/protocol-examples-policies-deletepolicy.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-deletepolicyentry.html b/2.0/protocol-examples-policies-deletepolicyentry.html
index 108785c..f75d62e 100644
--- a/2.0/protocol-examples-policies-deletepolicyentry.html
+++ b/2.0/protocol-examples-policies-deletepolicyentry.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-deleteresource.html b/2.0/protocol-examples-policies-deleteresource.html
index 8d20200..0b3b16c 100644
--- a/2.0/protocol-examples-policies-deleteresource.html
+++ b/2.0/protocol-examples-policies-deleteresource.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-deletesubject.html b/2.0/protocol-examples-policies-deletesubject.html
index be2a088..68a11df 100644
--- a/2.0/protocol-examples-policies-deletesubject.html
+++ b/2.0/protocol-examples-policies-deletesubject.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-errorresponses.html b/2.0/protocol-examples-policies-errorresponses.html
index 476986c..9149099 100644
--- a/2.0/protocol-examples-policies-errorresponses.html
+++ b/2.0/protocol-examples-policies-errorresponses.html
@@ -2114,7 +2114,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifypolicy.html b/2.0/protocol-examples-policies-modifypolicy.html
index 0171809..5472fad 100644
--- a/2.0/protocol-examples-policies-modifypolicy.html
+++ b/2.0/protocol-examples-policies-modifypolicy.html
@@ -1792,7 +1792,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifypolicyentries.html b/2.0/protocol-examples-policies-modifypolicyentries.html
index 81dc347..803e1a9 100644
--- a/2.0/protocol-examples-policies-modifypolicyentries.html
+++ b/2.0/protocol-examples-policies-modifypolicyentries.html
@@ -1811,7 +1811,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifypolicyentry.html b/2.0/protocol-examples-policies-modifypolicyentry.html
index 99d7d68..b3b32c2 100644
--- a/2.0/protocol-examples-policies-modifypolicyentry.html
+++ b/2.0/protocol-examples-policies-modifypolicyentry.html
@@ -1789,7 +1789,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifyresource.html b/2.0/protocol-examples-policies-modifyresource.html
index 79dac57..3a3adf5 100644
--- a/2.0/protocol-examples-policies-modifyresource.html
+++ b/2.0/protocol-examples-policies-modifyresource.html
@@ -1778,7 +1778,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifyresources.html b/2.0/protocol-examples-policies-modifyresources.html
index da029c6..b4b4aaa 100644
--- a/2.0/protocol-examples-policies-modifyresources.html
+++ b/2.0/protocol-examples-policies-modifyresources.html
@@ -1781,7 +1781,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifysubject.html b/2.0/protocol-examples-policies-modifysubject.html
index 67165cf..5661e8b 100644
--- a/2.0/protocol-examples-policies-modifysubject.html
+++ b/2.0/protocol-examples-policies-modifysubject.html
@@ -1774,7 +1774,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-modifysubjects.html b/2.0/protocol-examples-policies-modifysubjects.html
index d42039a..242f72c 100644
--- a/2.0/protocol-examples-policies-modifysubjects.html
+++ b/2.0/protocol-examples-policies-modifysubjects.html
@@ -1777,7 +1777,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrievepolicy.html b/2.0/protocol-examples-policies-retrievepolicy.html
index a9182f0..d71d35c 100644
--- a/2.0/protocol-examples-policies-retrievepolicy.html
+++ b/2.0/protocol-examples-policies-retrievepolicy.html
@@ -1792,7 +1792,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrievepolicyentries.html b/2.0/protocol-examples-policies-retrievepolicyentries.html
index 0ce59f7..464fb95 100644
--- a/2.0/protocol-examples-policies-retrievepolicyentries.html
+++ b/2.0/protocol-examples-policies-retrievepolicyentries.html
@@ -1805,7 +1805,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrievepolicyentry.html b/2.0/protocol-examples-policies-retrievepolicyentry.html
index e928dc7..c44b2bf 100644
--- a/2.0/protocol-examples-policies-retrievepolicyentry.html
+++ b/2.0/protocol-examples-policies-retrievepolicyentry.html
@@ -1787,7 +1787,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrieveresource.html b/2.0/protocol-examples-policies-retrieveresource.html
index 8756bd3..756c2c3 100644
--- a/2.0/protocol-examples-policies-retrieveresource.html
+++ b/2.0/protocol-examples-policies-retrieveresource.html
@@ -1778,7 +1778,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrieveresources.html b/2.0/protocol-examples-policies-retrieveresources.html
index d16b0e4..f238fec 100644
--- a/2.0/protocol-examples-policies-retrieveresources.html
+++ b/2.0/protocol-examples-policies-retrieveresources.html
@@ -1780,7 +1780,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrievesubject.html b/2.0/protocol-examples-policies-retrievesubject.html
index cc824c6..45f1b2b 100644
--- a/2.0/protocol-examples-policies-retrievesubject.html
+++ b/2.0/protocol-examples-policies-retrievesubject.html
@@ -1774,7 +1774,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-policies-retrievesubjects.html b/2.0/protocol-examples-policies-retrievesubjects.html
index 436eef1..a24766b 100644
--- a/2.0/protocol-examples-policies-retrievesubjects.html
+++ b/2.0/protocol-examples-policies-retrievesubjects.html
@@ -1776,7 +1776,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrieveattribute.html b/2.0/protocol-examples-retrieveattribute.html
index 0970124..e37b472 100644
--- a/2.0/protocol-examples-retrieveattribute.html
+++ b/2.0/protocol-examples-retrieveattribute.html
@@ -1775,7 +1775,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrieveattributes.html b/2.0/protocol-examples-retrieveattributes.html
index c7850db..cb7da61 100644
--- a/2.0/protocol-examples-retrieveattributes.html
+++ b/2.0/protocol-examples-retrieveattributes.html
@@ -1777,7 +1777,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievedefinition.html b/2.0/protocol-examples-retrievedefinition.html
index 93ea78f..32e197b 100644
--- a/2.0/protocol-examples-retrievedefinition.html
+++ b/2.0/protocol-examples-retrievedefinition.html
@@ -1774,7 +1774,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievedesiredproperties.html b/2.0/protocol-examples-retrievedesiredproperties.html
index 654b0f0..8dccb8f 100644
--- a/2.0/protocol-examples-retrievedesiredproperties.html
+++ b/2.0/protocol-examples-retrievedesiredproperties.html
@@ -1776,7 +1776,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievedesiredproperty.html b/2.0/protocol-examples-retrievedesiredproperty.html
index 1ff33fe..4b9c9e3 100644
--- a/2.0/protocol-examples-retrievedesiredproperty.html
+++ b/2.0/protocol-examples-retrievedesiredproperty.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievefeature.html b/2.0/protocol-examples-retrievefeature.html
index 3025b01..9dd8256 100644
--- a/2.0/protocol-examples-retrievefeature.html
+++ b/2.0/protocol-examples-retrievefeature.html
@@ -1785,7 +1785,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievefeatures.html b/2.0/protocol-examples-retrievefeatures.html
index 75d3bf2..e330536 100644
--- a/2.0/protocol-examples-retrievefeatures.html
+++ b/2.0/protocol-examples-retrievefeatures.html
@@ -1787,7 +1787,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrieveproperties.html b/2.0/protocol-examples-retrieveproperties.html
index a08c070..3fa2c3f 100644
--- a/2.0/protocol-examples-retrieveproperties.html
+++ b/2.0/protocol-examples-retrieveproperties.html
@@ -1777,7 +1777,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrieveproperty.html b/2.0/protocol-examples-retrieveproperty.html
index 0aa5e94..8cad49f 100644
--- a/2.0/protocol-examples-retrieveproperty.html
+++ b/2.0/protocol-examples-retrieveproperty.html
@@ -1772,7 +1772,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievething.html b/2.0/protocol-examples-retrievething.html
index b08b012..5828175 100644
--- a/2.0/protocol-examples-retrievething.html
+++ b/2.0/protocol-examples-retrievething.html
@@ -1809,7 +1809,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievethingdefinition.html b/2.0/protocol-examples-retrievethingdefinition.html
index efff998..95b416a 100644
--- a/2.0/protocol-examples-retrievethingdefinition.html
+++ b/2.0/protocol-examples-retrievethingdefinition.html
@@ -1772,7 +1772,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-retrievethings.html b/2.0/protocol-examples-retrievethings.html
index 52408aa..bbbf8a9 100644
--- a/2.0/protocol-examples-retrievethings.html
+++ b/2.0/protocol-examples-retrievethings.html
@@ -1804,7 +1804,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples-search.html b/2.0/protocol-examples-search.html
index 5bab8ef..0521905 100644
--- a/2.0/protocol-examples-search.html
+++ b/2.0/protocol-examples-search.html
@@ -1872,7 +1872,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-examples.html b/2.0/protocol-examples.html
index 7f1706d..4dae2be 100644
--- a/2.0/protocol-examples.html
+++ b/2.0/protocol-examples.html
@@ -1857,7 +1857,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-overview.html b/2.0/protocol-overview.html
index cf33bd3..de18ef7 100644
--- a/2.0/protocol-overview.html
+++ b/2.0/protocol-overview.html
@@ -1770,7 +1770,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-acks.html b/2.0/protocol-specification-acks.html
index 7a883b4..ca3c4b6 100644
--- a/2.0/protocol-specification-acks.html
+++ b/2.0/protocol-specification-acks.html
@@ -1794,7 +1794,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-errors.html b/2.0/protocol-specification-errors.html
index 290e9d0..bbc4c05 100644
--- a/2.0/protocol-specification-errors.html
+++ b/2.0/protocol-specification-errors.html
@@ -1771,7 +1771,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-policies-announcement.html b/2.0/protocol-specification-policies-announcement.html
index 2af931c..dc919c7 100644
--- a/2.0/protocol-specification-policies-announcement.html
+++ b/2.0/protocol-specification-policies-announcement.html
@@ -1798,7 +1798,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-policies-create-or-modify.html b/2.0/protocol-specification-policies-create-or-modify.html
index a6d02bd..3438e12 100644
--- a/2.0/protocol-specification-policies-create-or-modify.html
+++ b/2.0/protocol-specification-policies-create-or-modify.html
@@ -2331,7 +2331,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-policies-delete.html b/2.0/protocol-specification-policies-delete.html
index c0fe405..88977bb 100644
--- a/2.0/protocol-specification-policies-delete.html
+++ b/2.0/protocol-specification-policies-delete.html
@@ -2001,7 +2001,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-policies-retrieve.html b/2.0/protocol-specification-policies-retrieve.html
index 57dd876..601bc2d 100644
--- a/2.0/protocol-specification-policies-retrieve.html
+++ b/2.0/protocol-specification-policies-retrieve.html
@@ -2224,7 +2224,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-policies.html b/2.0/protocol-specification-policies.html
index c17e790..cd9e9a0 100644
--- a/2.0/protocol-specification-policies.html
+++ b/2.0/protocol-specification-policies.html
@@ -1840,7 +1840,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-create-or-modify.html b/2.0/protocol-specification-things-create-or-modify.html
index 77c8b0d..7730fab 100644
--- a/2.0/protocol-specification-things-create-or-modify.html
+++ b/2.0/protocol-specification-things-create-or-modify.html
@@ -3288,7 +3288,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-delete.html b/2.0/protocol-specification-things-delete.html
index a4ad05f..dd225c9 100644
--- a/2.0/protocol-specification-things-delete.html
+++ b/2.0/protocol-specification-things-delete.html
@@ -2695,7 +2695,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-merge.html b/2.0/protocol-specification-things-merge.html
index 4895038..10f5ff1 100644
--- a/2.0/protocol-specification-things-merge.html
+++ b/2.0/protocol-specification-things-merge.html
@@ -2833,7 +2833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-messages.html b/2.0/protocol-specification-things-messages.html
index 199de29..b6e13ef 100644
--- a/2.0/protocol-specification-things-messages.html
+++ b/2.0/protocol-specification-things-messages.html
@@ -2014,7 +2014,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-retrieve.html b/2.0/protocol-specification-things-retrieve.html
index 7e4d82e..5679463 100644
--- a/2.0/protocol-specification-things-retrieve.html
+++ b/2.0/protocol-specification-things-retrieve.html
@@ -2587,7 +2587,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things-search.html b/2.0/protocol-specification-things-search.html
index b3a7a13..86e4d61 100644
--- a/2.0/protocol-specification-things-search.html
+++ b/2.0/protocol-specification-things-search.html
@@ -2118,7 +2118,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-things.html b/2.0/protocol-specification-things.html
index 9badab9..a8447c5 100644
--- a/2.0/protocol-specification-things.html
+++ b/2.0/protocol-specification-things.html
@@ -1842,7 +1842,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification-topic.html b/2.0/protocol-specification-topic.html
index bc94403..1fd17ca 100644
--- a/2.0/protocol-specification-topic.html
+++ b/2.0/protocol-specification-topic.html
@@ -1940,7 +1940,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-specification.html b/2.0/protocol-specification.html
index 38d4151..af718b0 100644
--- a/2.0/protocol-specification.html
+++ b/2.0/protocol-specification.html
@@ -1935,7 +1935,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/protocol-twinlive.html b/2.0/protocol-twinlive.html
index add92f2..30cb35b 100644
--- a/2.0/protocol-twinlive.html
+++ b/2.0/protocol-twinlive.html
@@ -1781,7 +1781,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_010-M1.html b/2.0/release_notes_010-M1.html
index d60cdd9..bc06c86 100644
--- a/2.0/release_notes_010-M1.html
+++ b/2.0/release_notes_010-M1.html
@@ -1760,7 +1760,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_010-M3.html b/2.0/release_notes_010-M3.html
index 61dc4f7..395c788 100644
--- a/2.0/release_notes_010-M3.html
+++ b/2.0/release_notes_010-M3.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_020-M1.html b/2.0/release_notes_020-M1.html
index d5f9ab6..0a29d61 100644
--- a/2.0/release_notes_020-M1.html
+++ b/2.0/release_notes_020-M1.html
@@ -1801,7 +1801,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_030-M1.html b/2.0/release_notes_030-M1.html
index 6ee3585..1229454 100644
--- a/2.0/release_notes_030-M1.html
+++ b/2.0/release_notes_030-M1.html
@@ -1812,7 +1812,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_030-M2.html b/2.0/release_notes_030-M2.html
index 9872319..ef1fb38 100644
--- a/2.0/release_notes_030-M2.html
+++ b/2.0/release_notes_030-M2.html
@@ -1809,7 +1809,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_080-M1.html b/2.0/release_notes_080-M1.html
index 3a9c687..8b7fac1 100644
--- a/2.0/release_notes_080-M1.html
+++ b/2.0/release_notes_080-M1.html
@@ -1831,7 +1831,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_080-M2.html b/2.0/release_notes_080-M2.html
index 1e99d3d..ab5e6b6 100644
--- a/2.0/release_notes_080-M2.html
+++ b/2.0/release_notes_080-M2.html
@@ -1815,7 +1815,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_080-M3.html b/2.0/release_notes_080-M3.html
index de35761..4e7f142 100644
--- a/2.0/release_notes_080-M3.html
+++ b/2.0/release_notes_080-M3.html
@@ -1819,7 +1819,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_080.html b/2.0/release_notes_080.html
index 6bd9070..084e563 100644
--- a/2.0/release_notes_080.html
+++ b/2.0/release_notes_080.html
@@ -1825,7 +1825,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_090-M1.html b/2.0/release_notes_090-M1.html
index b5b97fd..aabce6e 100644
--- a/2.0/release_notes_090-M1.html
+++ b/2.0/release_notes_090-M1.html
@@ -1797,7 +1797,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_090-M2.html b/2.0/release_notes_090-M2.html
index d104473..8547f24 100644
--- a/2.0/release_notes_090-M2.html
+++ b/2.0/release_notes_090-M2.html
@@ -1798,7 +1798,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_090.html b/2.0/release_notes_090.html
index 2ad61c9..582fcc0 100644
--- a/2.0/release_notes_090.html
+++ b/2.0/release_notes_090.html
@@ -1855,7 +1855,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_100-M1a.html b/2.0/release_notes_100-M1a.html
index 25af2a7..f32782b 100644
--- a/2.0/release_notes_100-M1a.html
+++ b/2.0/release_notes_100-M1a.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_100-M2.html b/2.0/release_notes_100-M2.html
index ccaefee..b634d34 100644
--- a/2.0/release_notes_100-M2.html
+++ b/2.0/release_notes_100-M2.html
@@ -1833,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_100.html b/2.0/release_notes_100.html
index 1b1db48..f8c50f5 100644
--- a/2.0/release_notes_100.html
+++ b/2.0/release_notes_100.html
@@ -1836,7 +1836,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_110.html b/2.0/release_notes_110.html
index 2943ee2..28972d1 100644
--- a/2.0/release_notes_110.html
+++ b/2.0/release_notes_110.html
@@ -1877,7 +1877,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_111.html b/2.0/release_notes_111.html
index 427f880..c05d486 100644
--- a/2.0/release_notes_111.html
+++ b/2.0/release_notes_111.html
@@ -1775,7 +1775,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_112.html b/2.0/release_notes_112.html
index b9debe3..951115d 100644
--- a/2.0/release_notes_112.html
+++ b/2.0/release_notes_112.html
@@ -1791,7 +1791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_113.html b/2.0/release_notes_113.html
index 4cc1bda..f706ef1 100644
--- a/2.0/release_notes_113.html
+++ b/2.0/release_notes_113.html
@@ -1791,7 +1791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_115.html b/2.0/release_notes_115.html
index abf50fd..24a1d79 100644
--- a/2.0/release_notes_115.html
+++ b/2.0/release_notes_115.html
@@ -1779,7 +1779,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_120.html b/2.0/release_notes_120.html
index 3c4f0a9..d125521 100644
--- a/2.0/release_notes_120.html
+++ b/2.0/release_notes_120.html
@@ -1851,7 +1851,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_121.html b/2.0/release_notes_121.html
index 5e1bd2c..92fc62e 100644
--- a/2.0/release_notes_121.html
+++ b/2.0/release_notes_121.html
@@ -1778,7 +1778,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_130.html b/2.0/release_notes_130.html
index 5cf952e..b283077 100644
--- a/2.0/release_notes_130.html
+++ b/2.0/release_notes_130.html
@@ -1868,7 +1868,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_140.html b/2.0/release_notes_140.html
index fed5afb..a783d3d 100644
--- a/2.0/release_notes_140.html
+++ b/2.0/release_notes_140.html
@@ -1845,7 +1845,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_150.html b/2.0/release_notes_150.html
index 9a6a5a9..0673c6b 100644
--- a/2.0/release_notes_150.html
+++ b/2.0/release_notes_150.html
@@ -1879,7 +1879,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_151.html b/2.0/release_notes_151.html
index 065748a..d758d25 100644
--- a/2.0/release_notes_151.html
+++ b/2.0/release_notes_151.html
@@ -1767,7 +1767,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_200.html b/2.0/release_notes_200.html
index fc9b0cb..65e37a3 100644
--- a/2.0/release_notes_200.html
+++ b/2.0/release_notes_200.html
@@ -2430,7 +2430,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/release_notes_201.html b/2.0/release_notes_201.html
index 52f98a8..07320cd 100644
--- a/2.0/release_notes_201.html
+++ b/2.0/release_notes_201.html
@@ -1791,7 +1791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/sandbox.html b/2.0/sandbox.html
index 418c500..bb78467 100644
--- a/2.0/sandbox.html
+++ b/2.0/sandbox.html
@@ -1816,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_advanced.html b/2.0/tag_advanced.html
index e82bbee..0dd0f6c 100644
--- a/2.0/tag_advanced.html
+++ b/2.0/tag_advanced.html
@@ -2667,7 +2667,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_architecture.html b/2.0/tag_architecture.html
index 3eb39f8..d8a405e 100644
--- a/2.0/tag_architecture.html
+++ b/2.0/tag_architecture.html
@@ -2715,7 +2715,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_blog.html b/2.0/tag_blog.html
index 257b83a..d3f8b0e 100644
--- a/2.0/tag_blog.html
+++ b/2.0/tag_blog.html
@@ -2907,7 +2907,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_client_sdk.html b/2.0/tag_client_sdk.html
index 044b379..d0d4fc6 100644
--- a/2.0/tag_client_sdk.html
+++ b/2.0/tag_client_sdk.html
@@ -2689,7 +2689,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_connectivity.html b/2.0/tag_connectivity.html
index 7aeebc0..d440493 100644
--- a/2.0/tag_connectivity.html
+++ b/2.0/tag_connectivity.html
@@ -2793,7 +2793,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_getting_started.html b/2.0/tag_getting_started.html
index 85105ee..4e661d4 100644
--- a/2.0/tag_getting_started.html
+++ b/2.0/tag_getting_started.html
@@ -2711,7 +2711,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_http.html b/2.0/tag_http.html
index 4cc429e..10442ac 100644
--- a/2.0/tag_http.html
+++ b/2.0/tag_http.html
@@ -2709,7 +2709,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_installation.html b/2.0/tag_installation.html
index 7a7ca54..d3eb8e3 100644
--- a/2.0/tag_installation.html
+++ b/2.0/tag_installation.html
@@ -2679,7 +2679,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_model.html b/2.0/tag_model.html
index 1ba99ed..d1db0cb 100644
--- a/2.0/tag_model.html
+++ b/2.0/tag_model.html
@@ -2733,7 +2733,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_news.html b/2.0/tag_news.html
index 7c106f3..9a6fcdc 100644
--- a/2.0/tag_news.html
+++ b/2.0/tag_news.html
@@ -2661,7 +2661,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_protocol.html b/2.0/tag_protocol.html
index 87b0861..17bb2d6 100644
--- a/2.0/tag_protocol.html
+++ b/2.0/tag_protocol.html
@@ -2847,7 +2847,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_release_notes.html b/2.0/tag_release_notes.html
index 0e4dde3..c2e6cd9 100644
--- a/2.0/tag_release_notes.html
+++ b/2.0/tag_release_notes.html
@@ -2829,7 +2829,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_rql.html b/2.0/tag_rql.html
index 73424bd..1172fa8 100644
--- a/2.0/tag_rql.html
+++ b/2.0/tag_rql.html
@@ -2727,7 +2727,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_search.html b/2.0/tag_search.html
index d50f0ca..f363c7e 100644
--- a/2.0/tag_search.html
+++ b/2.0/tag_search.html
@@ -2697,7 +2697,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_signal.html b/2.0/tag_signal.html
index 4f644b0..23bedfd 100644
--- a/2.0/tag_signal.html
+++ b/2.0/tag_signal.html
@@ -2702,7 +2702,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/tag_troubleshooting.html b/2.0/tag_troubleshooting.html
index b764c43..069c111 100644
--- a/2.0/tag_troubleshooting.html
+++ b/2.0/tag_troubleshooting.html
@@ -2675,7 +2675,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2017-11-10-welcome-to-ditto.html b/2017-11-10-welcome-to-ditto.html
index 8734d0a..edf8224 100644
--- a/2017-11-10-welcome-to-ditto.html
+++ b/2017-11-10-welcome-to-ditto.html
@@ -280,7 +280,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2017-12-18-milestone-announcement-010-M1.html b/2017-12-18-milestone-announcement-010-M1.html
index 8f4cc7b..972a971 100644
--- a/2017-12-18-milestone-announcement-010-M1.html
+++ b/2017-12-18-milestone-announcement-010-M1.html
@@ -284,7 +284,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-01-12-milestone-announcement-010-M3.html b/2018-01-12-milestone-announcement-010-M3.html
index 9e3b81d..3138630 100644
--- a/2018-01-12-milestone-announcement-010-M3.html
+++ b/2018-01-12-milestone-announcement-010-M3.html
@@ -303,7 +303,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-01-15-example-demonstrating-rest-to-websocket.html b/2018-01-15-example-demonstrating-rest-to-websocket.html
index 5163985..3650641 100644
--- a/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -292,7 +292,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-02-07-milestone-announcement-020-M1.html b/2018-02-07-milestone-announcement-020-M1.html
index 2a1072c..4deb718 100644
--- a/2018-02-07-milestone-announcement-020-M1.html
+++ b/2018-02-07-milestone-announcement-020-M1.html
@@ -304,7 +304,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-02-08-feature-definition.html b/2018-02-08-feature-definition.html
index 3374e0a..6fbd39d 100644
--- a/2018-02-08-feature-definition.html
+++ b/2018-02-08-feature-definition.html
@@ -334,7 +334,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-04-25-connectivity-service.html b/2018-04-25-connectivity-service.html
index 1e1f8c2..9f1404d 100644
--- a/2018-04-25-connectivity-service.html
+++ b/2018-04-25-connectivity-service.html
@@ -348,7 +348,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-04-26-milestone-announcement-030-M1.html b/2018-04-26-milestone-announcement-030-M1.html
index e2a2f73..415de2c 100644
--- a/2018-04-26-milestone-announcement-030-M1.html
+++ b/2018-04-26-milestone-announcement-030-M1.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-05-02-connecting-ditto-hono.html b/2018-05-02-connecting-ditto-hono.html
index 2d241fa..b5a3f5d 100644
--- a/2018-05-02-connecting-ditto-hono.html
+++ b/2018-05-02-connecting-ditto-hono.html
@@ -1022,7 +1022,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-06-15-milestone-announcement-030-M2.html b/2018-06-15-milestone-announcement-030-M2.html
index 66505e1..9c52aea 100644
--- a/2018-06-15-milestone-announcement-030-M2.html
+++ b/2018-06-15-milestone-announcement-030-M2.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-08-14-milestone-announcement-080-M1.html b/2018-08-14-milestone-announcement-080-M1.html
index 4f01c22..09f4aaa 100644
--- a/2018-08-14-milestone-announcement-080-M1.html
+++ b/2018-08-14-milestone-announcement-080-M1.html
@@ -300,7 +300,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-09-21-selective-push-notifications.html b/2018-09-21-selective-push-notifications.html
index 5b63497..eb01e18 100644
--- a/2018-09-21-selective-push-notifications.html
+++ b/2018-09-21-selective-push-notifications.html
@@ -500,7 +500,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-09-27-milestone-announcement-080-M2.html b/2018-09-27-milestone-announcement-080-M2.html
index ae28ffd..4ce47e2 100644
--- a/2018-09-27-milestone-announcement-080-M2.html
+++ b/2018-09-27-milestone-announcement-080-M2.html
@@ -302,7 +302,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-10-16-example-mqtt-bidirectional.html b/2018-10-16-example-mqtt-bidirectional.html
index ba7210b..37fcb95 100644
--- a/2018-10-16-example-mqtt-bidirectional.html
+++ b/2018-10-16-example-mqtt-bidirectional.html
@@ -308,7 +308,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-11-14-milestone-announcement-080-M3.html b/2018-11-14-milestone-announcement-080-M3.html
index 4d45e73..f62d754 100644
--- a/2018-11-14-milestone-announcement-080-M3.html
+++ b/2018-11-14-milestone-announcement-080-M3.html
@@ -301,7 +301,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-11-28-release-announcement-080.html b/2018-11-28-release-announcement-080.html
index 91338e6..ef5e20e 100644
--- a/2018-11-28-release-announcement-080.html
+++ b/2018-11-28-release-announcement-080.html
@@ -296,7 +296,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2018-12-05-example-command-and-control.html b/2018-12-05-example-command-and-control.html
index 4ba1098..34fb505 100644
--- a/2018-12-05-example-command-and-control.html
+++ b/2018-12-05-example-command-and-control.html
@@ -535,7 +535,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-03-13-kafka-connectivity.html b/2019-03-13-kafka-connectivity.html
index 5a2e357..888c35a 100644
--- a/2019-03-13-kafka-connectivity.html
+++ b/2019-03-13-kafka-connectivity.html
@@ -282,7 +282,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-03-28-milestone-announcement-090-M1.html b/2019-03-28-milestone-announcement-090-M1.html
index 731c39e..f3172d3 100644
--- a/2019-03-28-milestone-announcement-090-M1.html
+++ b/2019-03-28-milestone-announcement-090-M1.html
@@ -298,7 +298,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-04-29-milestone-announcement-090-M2.html b/2019-04-29-milestone-announcement-090-M2.html
index 45e53de..a03a342 100644
--- a/2019-04-29-milestone-announcement-090-M2.html
+++ b/2019-04-29-milestone-announcement-090-M2.html
@@ -296,7 +296,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-07-10-release-announcement-090.html b/2019-07-10-release-announcement-090.html
index e8cbe6c..2088c90 100644
--- a/2019-07-10-release-announcement-090.html
+++ b/2019-07-10-release-announcement-090.html
@@ -302,7 +302,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-08-28-openid-connect.html b/2019-08-28-openid-connect.html
index e04a4dc..459829e 100644
--- a/2019-08-28-openid-connect.html
+++ b/2019-08-28-openid-connect.html
@@ -348,7 +348,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-09-17-milestone-announcement-100-M1a.html b/2019-09-17-milestone-announcement-100-M1a.html
index 1c6a30a..f250509 100644
--- a/2019-09-17-milestone-announcement-100-M1a.html
+++ b/2019-09-17-milestone-announcement-100-M1a.html
@@ -299,7 +299,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-10-17-http-connectivity.html b/2019-10-17-http-connectivity.html
index 007c5ac..f463df2 100644
--- a/2019-10-17-http-connectivity.html
+++ b/2019-10-17-http-connectivity.html
@@ -307,7 +307,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-11-04-milestone-announcement-100-M2.html b/2019-11-04-milestone-announcement-100-M2.html
index cf6fbbe..55dd3ff 100644
--- a/2019-11-04-milestone-announcement-100-M2.html
+++ b/2019-11-04-milestone-announcement-100-M2.html
@@ -298,7 +298,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2019-12-12-release-announcement-100.html b/2019-12-12-release-announcement-100.html
index 7b881fb..02ccbad 100644
--- a/2019-12-12-release-announcement-100.html
+++ b/2019-12-12-release-announcement-100.html
@@ -347,7 +347,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-04-16-connecting-to-ttn-via-mqtt.html b/2020-04-16-connecting-to-ttn-via-mqtt.html
index c7006c0..38ae9e8 100644
--- a/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -794,7 +794,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-04-29-release-announcement-110.html b/2020-04-29-release-announcement-110.html
index ba58482..3a2ef18 100644
--- a/2020-04-29-release-announcement-110.html
+++ b/2020-04-29-release-announcement-110.html
@@ -328,7 +328,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-08-31-release-announcement-120.html b/2020-08-31-release-announcement-120.html
index b727855..23672bf 100644
--- a/2020-08-31-release-announcement-120.html
+++ b/2020-08-31-release-announcement-120.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-09-30-release-announcement-130.html b/2020-09-30-release-announcement-130.html
index 378a8b2..76bc692 100644
--- a/2020-09-30-release-announcement-130.html
+++ b/2020-09-30-release-announcement-130.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-08-asynchronous-client-creation.html b/2020-10-08-asynchronous-client-creation.html
index 86aa672..2cb51ad 100644
--- a/2020-10-08-asynchronous-client-creation.html
+++ b/2020-10-08-asynchronous-client-creation.html
@@ -340,7 +340,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-23-end-2-end-acknowledgment.html b/2020-10-23-end-2-end-acknowledgment.html
index e6020bb..3b9fd61 100644
--- a/2020-10-23-end-2-end-acknowledgment.html
+++ b/2020-10-23-end-2-end-acknowledgment.html
@@ -581,7 +581,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-28-release-announcement-140.html b/2020-10-28-release-announcement-140.html
index 6968b04..52441aa 100644
--- a/2020-10-28-release-announcement-140.html
+++ b/2020-10-28-release-announcement-140.html
@@ -304,7 +304,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-11-11-desired-properties.html b/2020-11-11-desired-properties.html
index 1a2503a..9004581 100644
--- a/2020-11-11-desired-properties.html
+++ b/2020-11-11-desired-properties.html
@@ -408,7 +408,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-11-16-weak-acknowledgements.html b/2020-11-16-weak-acknowledgements.html
index e7a6b82..bc4f34c 100644
--- a/2020-11-16-weak-acknowledgements.html
+++ b/2020-11-16-weak-acknowledgements.html
@@ -365,7 +365,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-12-10-release-announcement-150.html b/2020-12-10-release-announcement-150.html
index d6282a9..1028048 100644
--- a/2020-12-10-release-announcement-150.html
+++ b/2020-12-10-release-announcement-150.html
@@ -306,7 +306,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-01-22-policy-subject-activate-token-integration.html b/2021-01-22-policy-subject-activate-token-integration.html
index 2adfef4..2d87c13 100644
--- a/2021-01-22-policy-subject-activate-token-integration.html
+++ b/2021-01-22-policy-subject-activate-token-integration.html
@@ -465,7 +465,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-02-04-merge-feature.html b/2021-02-04-merge-feature.html
index 3c7af93..601215f 100644
--- a/2021-02-04-merge-feature.html
+++ b/2021-02-04-merge-feature.html
@@ -604,7 +604,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-03-22-azure-iot-hub-integration.html b/2021-03-22-azure-iot-hub-integration.html
index 344f623..b419416 100644
--- a/2021-03-22-azure-iot-hub-integration.html
+++ b/2021-03-22-azure-iot-hub-integration.html
@@ -521,7 +521,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-03-31-ssh-tunneling-for-managed-connections.html b/2021-03-31-ssh-tunneling-for-managed-connections.html
index 03770d6..4bf66b0 100644
--- a/2021-03-31-ssh-tunneling-for-managed-connections.html
+++ b/2021-03-31-ssh-tunneling-for-managed-connections.html
@@ -382,7 +382,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-05-06-release-announcement-200.html b/2021-05-06-release-announcement-200.html
index 97d5651..60b18b4 100644
--- a/2021-05-06-release-announcement-200.html
+++ b/2021-05-06-release-announcement-200.html
@@ -343,7 +343,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-06-17-hmac-credentials.html b/2021-06-17-hmac-credentials.html
new file mode 100644
index 0000000..ce62de34
--- /dev/null
+++ b/2021-06-17-hmac-credentials.html
@@ -0,0 +1,689 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="blogarchitectureconnectivityhmacazureazure iot hubazure service busazure monitoraws snssnsawssigningexample,  ">
+<title>  Support for HMAC-SHA256 signing for connections </title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="Support for HMAC-SHA256 signing for connections">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+
+        <!-- Content Column -->
+        <div class="col-md-12" id="tg-sb-content">
+            <!-- Look the author details up from the site config. -->
+
+
+<!-- Output author details if some exist. -->
+<!-- Output author details if some exist. -->
+<!---->
+<!--<span>-->
+    <!--&lt;!&ndash; Mugshot. &ndash;&gt;-->
+    <!--<img src="https://www.gravatar.com/avatar/9ca96e4eae3d3cf7df52ece39dc0b2fb?s=135" alt="A photo of Florian Fendt" />-->
+
+<!--&lt;!&ndash; Personal Info. &ndash;&gt;-->
+    <!--Written by <a href="https://github.com/ffendt" target="_blank">Florian Fendt</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+    <header class="post-header">
+        <h1 class="post-title" itemprop="name headline">Support for HMAC-SHA256 signing for connections</h1>
+        <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/9ca96e4eae3d3cf7df52ece39dc0b2fb?s=135" alt="A photo of Florian Fendt" style="width:50px;border-radius:50%;display:inline-block;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="https://github.com/ffendt" target="_blank">Florian Fendt</a> </span></span> on <time datetime="2021-06-17T00:00:00+00:00" itemprop="datePublished">Jun 17, 2021</time> - Tags:
+            
+            
+            
+            <a href="tag_blog.html">blog</a>, 
+            
+            
+            
+            <a href="tag_architecture.html">architecture</a>, 
+            
+            
+            
+            <a href="tag_connectivity.html">connectivity</a>, 
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+
+        </p>
+
+
+    </header>
+
+    <div class="post-content" itemprop="articleBody">
+
+        
+
+        
+        
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+        
+
+        <p>With the upcoming release of Eclipse Ditto <strong>version 2.1.0</strong> it will be possible to use HMAC-SHA256 signing for
+connections. The currently implemented algorithms support you in authenticating requests against:</p>
+<ul>
+  <li>Azure IoT Hub REST API</li>
+  <li>Azure IoT Hub AMQP 1.0</li>
+  <li>Azure HTTP Monitor Data Collector API</li>
+  <li>Azure Service Bus REST API</li>
+  <li>Amazon Simple Notification Service (Amazon SNS)</li>
+  <li>other AWS services supporting Signature Version 4 signing (see external AWS documentation on 
+<a href="https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html">Signing AWS API requests</a>)</li>
+</ul>
+
+<p>Detailed information can be found at <a href="connectivity-hmac-signing.html">Connectivity API &gt; HMAC request signing</a>.</p>
+
+<p>This blog post shows different configurations with the <code class="highlighter-rouge">az-sasl</code> algorithm, that allow you to sign requests
+against Azure IoT Hub (HTTP Push and AMQP 1.0) as well as Azure Service Bus (HTTP Push).</p>
+
+<h1 id="prerequisites">Prerequisites</h1>
+
+<p>For the examples you’ll need a running instance of Eclipse Ditto (see <a href="installation-running.html">Running Ditto</a>).
+Additionally, a simple Thing is required, to which messages can be sent to.
+Create the Thing <code class="highlighter-rouge">ditto:thing</code> with a <code class="highlighter-rouge">PUT</code> request to <code class="highlighter-rouge">&lt;ditto&gt;/api/2/things/ditto:thing</code> and content</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+  </span><span class="s2">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ditto:thing"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+  </span><span class="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+  </span><span class="s2">"_policy"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"DEFAULT"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+          </span><span class="s2">"{{ request:subjectId }}"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"the creator"</span><span class="w">
+          </span><span class="p">},</span><span class="w">
+          </span><span class="s2">"integration:ditto"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"the connections"</span><span class="w">
+          </span><span class="p">}</span><span class="w">
+        </span><span class="p">},</span><span class="w">
+        </span><span class="s2">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+          </span><span class="s2">"policy:/"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+              </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+              </span><span class="s2">"WRITE"</span><span class="w">
+            </span><span class="p">],</span><span class="w">
+            </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+          </span><span class="p">},</span><span class="w">
+          </span><span class="s2">"thing:/"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+              </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+              </span><span class="s2">"WRITE"</span><span class="w">
+            </span><span class="p">],</span><span class="w">
+            </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+          </span><span class="p">},</span><span class="w">
+          </span><span class="s2">"message:/"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+            </span><span class="s2">"grant"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+              </span><span class="s2">"READ"</span><span class="p">,</span><span class="w">
+              </span><span class="s2">"WRITE"</span><span class="w">
+            </span><span class="p">],</span><span class="w">
+            </span><span class="s2">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+          </span><span class="p">}</span><span class="w">
+        </span><span class="p">}</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h1 id="azure-iot-hub-rest-api">Azure IoT Hub REST API</h1>
+
+<p>This example shows how to invoke a <a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-direct-methods">direct method</a>
+on a device using Eclipse Ditto and Azure IoT Hub.</p>
+
+<p>For creating signed requests against the Azure IoT Hub REST API, you’ll need the following information from your
+Azure IoT Hub instance:</p>
+<ul>
+  <li>The hostname (e.g. <code class="highlighter-rouge">my-hub.azure-devices.net</code>).</li>
+  <li>The name of a (Azure IoT Hub) shared access policy, which has the <code class="highlighter-rouge">Service connect</code> permission. By default, there
+should be a policy named <code class="highlighter-rouge">service</code> which provides this permission.</li>
+  <li>The primary or secondary key of above policy.</li>
+  <li>A device in Azure IoT Hub with the ID <code class="highlighter-rouge">ditto:thing</code> (for the example this needs to be the same ID as the Thing created in prerequisites).</li>
+</ul>
+
+<p>What follows is a sample connection JSON for a connection named <code class="highlighter-rouge">Azure IoT Hub HTTP</code>, using hostname <code class="highlighter-rouge">my-hub.azure-devices.net</code> and
+shared access policy <code class="highlighter-rouge">service</code> with key <code class="highlighter-rouge">theKey</code>. You can set the correct values from your Azure IoT Hub subscription
+in the fields <code class="highlighter-rouge">uri</code>, <code class="highlighter-rouge">credentials.parameters.sharedKeyName</code>, <code class="highlighter-rouge">credentials.parameters.sharedKey</code> and
+<code class="highlighter-rouge">credentials.parameters.endpoint</code>.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+		</span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"60d193e3-2639-415b-af29-0e337741141d"</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure IoT Hub HTTP"</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://my-hub.azure-devices.net:443"</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+		</span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+				</span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"POST:/twins/{{ thing:id }}/methods?api-version=2018-06-30"</span><span class="p">,</span><span class="w">
+				</span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+				</span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+				</span><span class="s2">"issuedAcknowledgementLabel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"live-response"</span><span class="p">,</span><span class="w">
+				</span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+				</span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"javascript"</span><span class="p">]</span><span class="w">
+			</span><span class="p">}</span><span class="w">
+		</span><span class="p">],</span><span class="w">
+		</span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+		</span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+			</span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+		</span><span class="p">},</span><span class="w">
+		</span><span class="s2">"mappingDefinitions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+			</span><span class="s2">"javascript"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+				</span><span class="s2">"mappingEngine"</span><span class="p">:</span><span class="w"> </span><span class="s2">"JavaScript"</span><span class="p">,</span><span class="w">
+				</span><span class="s2">"options"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+                    </span><span class="s2">"incomingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapToDittoProtocolMsg(</span><span class="se">\n</span><span class="s2">  headers,</span><span class="se">\n</span><span class="s2">  textPayload,</span><span class="se">\n</span><span class="s2">  bytePayload,</span><span class="se">\n</span><span class="s2">  contentType</span><span class="se">\n</span><span class="s2">) {</span><span class="se">\n\n</span><span class="s2">  if (contentType === 'application/vnd.eclipse.ditto+json') {</span><span class="se">\n</span><span class="s2">    return JSON.parse(textPayload);</span><span class="se">\n</span><span class="s2">  } else if (contentType === 'application/octet-stream') {</span><span class="se">\n</span><span class="s2">    try {</span><span class="se">\n</span><span class="s2">      return JSON.parse(Ditto.arrayBufferToString(bytePayload));</span><span class="se">\n</span><span class="s2">    } catch (e) {</span><span class="se">\n</span><span class="s2">      return null;</span><span class="se">\n</span><span class="s2">    }</span><span class="se">\n</span><span class="s2">  }</span><span class="se">\n</span><span class="s2">  return null;</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+                    </span><span class="s2">"outgoingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapFromDittoProtocolMsg(</span><span class="se">\n</span><span class="s2">  namespace,</span><span class="se">\n</span><span class="s2">  name,</span><span class="se">\n</span><span class="s2">  group,</span><span class="se">\n</span><span class="s2">  channel,</span><span class="se">\n</span><span class="s2">  criterion,</span><span class="se">\n</span><span class="s2">  action,</span><span class="se">\n</span><span class="s2">  path,</span><span class="se">\n</span><span class="s2">  dittoHeaders,</span><span class="se">\n</span><span class="s2">  value,</span><span class="se">\n</span><span class="s2">  status,</span><span class="se">\n</span><span class="s2">  extra</span><span class="se">\n</span><span class="s2">) {</span><span class="se">\n\n</span><span class="s2">  let headers = dittoHeaders;</span><span class="se">\n</span><span class="s2">  let payload = {</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">methodName</span><span class="se">\"</span><span class="s2">: action,</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">responseTimeoutInSeconds</span><span class="se">\"</span><span class="s2">: parseInt(dittoHeaders.timeout),</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">payload</span><span class="se">\"</span><span class="s2">: value</span><span class="se">\n</span><span class="s2">  };</span><span class="se">\n</span><span class="s2">  let textPayload = JSON.stringify(payload);</span><span class="se">\n</span><span class="s2">  let bytePayload = null;</span><span class="se">\n</span><span class="s2">  let contentType = 'application/json';</span><span class="se">\n\n</span><span class="s2">  return Ditto.buildExternalMsg(</span><span class="se">\n</span><span class="s2">    headers, // The external headers Object containing header values</span><span class="se">\n</span><span class="s2">    textPayload, // The external mapped String</span><span class="se">\n</span><span class="s2">    bytePayload, // The external mapped byte[]</span><span class="se">\n</span><span class="s2">    contentType // The returned Content-Type</span><span class="se">\n</span><span class="s2">  );</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+                    </span><span class="s2">"loadBytebufferJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="p">,</span><span class="w">
+					</span><span class="s2">"loadLongJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="w">
+				</span><span class="p">}</span><span class="w">
+			</span><span class="p">}</span><span class="w">
+		</span><span class="p">},</span><span class="w">
+		</span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+			</span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+			</span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+			</span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+				</span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"service"</span><span class="p">,</span><span class="w">
+				</span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"theKey"</span><span class="p">,</span><span class="w">
+				</span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-hub.azure-devices.net"</span><span class="w">
+			</span><span class="p">}</span><span class="w">
+		</span><span class="p">},</span><span class="w">
+		</span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+	</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>This connection configuration sends live messages to the endpoint at
+<code class="highlighter-rouge">https://my-hub.azure-devices.net:443/twins/{{ thing:id }}/methods?api-version=2018-06-30</code>
+and signs each request with a <a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-dev-guide-sas?tabs=node">Shared Access Signature</a>.
+The configuration also contains an outgoing JavaScript payload mapping, which extracts the subject of the live message,
+its timeout and its payload and uses this to construct a JSON message in the required direct method format.
+You’ll see that format below.</p>
+
+<h2 id="listen-for-direct-method-on-the-device">Listen for direct method on the device</h2>
+
+<p>Your Azure IoT Hub device needs to listen to the direct method you’re calling. Imagine you want to call a
+device method <code class="highlighter-rouge">getDeviceLog</code> on a device. You can use the Nodejs sample <a href="https://github.com/Azure/azure-iot-sdk-node/blob/f526f203ddc9ee32e3c92066312417d2ef6303de/device/samples/device_methods.js">device_methods.js from azure-iot-sdk-node/device/samples</a>
+as a starter. You’ll need to set the <code class="highlighter-rouge">DEVICE_CONNECTION_STRING</code> environment variable to a connection string of the
+device you are using and can run the device with <code class="highlighter-rouge">npm install &amp;&amp; node device_methods.js</code>.</p>
+
+<h2 id="send-a-live-message-to-the-thing">Send a live message to the Thing</h2>
+
+<p>To invoke the <code class="highlighter-rouge">getDeviceLog</code> method on the device, you should now be able to send a live message to the Thing. The message
+will be forwarded through your connection <code class="highlighter-rouge">Azure IoT Hub HTTP</code> to the Azure IoT Hub, which will route it to the device
+and respond with its response.</p>
+
+<p><code class="highlighter-rouge">POST</code> a message to <code class="highlighter-rouge">&lt;ditto&gt;/api/2/things/ditto:thing/inbox/messages/getDeviceLog?timeout=5s</code> with content:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-microservice"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"amount"</span><span class="p">:</span><span class="w"> </span><span class="mi">9000</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The payload mapping of the connection will turn this into a direct method:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"methodName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"getDeviceLog"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"responseTimeoutInSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-microservice"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"amount"</span><span class="p">:</span><span class="w"> </span><span class="mi">9000</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>If you didn’t change the sample code of the device, you should get a response containing <code class="highlighter-rouge">example payload</code>.</p>
+
+<h1 id="azure-iot-hub-amqp">Azure IoT Hub AMQP</h1>
+
+<p>For using the Azure IoT Hub AMQP endpoint, basically the same prerequisites as for the HTTP endpoint apply.
+The difference is, that it’s not possible to invoke direct methods using the AMQP endpoint. Instead, you can
+send a Cloud To Device (C2D) message, on which the device listens.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Instead of signing each request like in HTTP push connections, the connection itself is
+established with signed connection information. For this, the <code class="highlighter-rouge">ttl</code> parameter of the <code class="highlighter-rouge">az-sasl</code> algorithm applies 
+(see <a href="connectivity-hmac-signing.html#az-sasl">documentation of the az-sasl algorithm</a>).</div>
+
+<p>You can use the Nodejs sample <a href="https://github.com/Azure/azure-iot-sdk-node/blob/f526f203ddc9ee32e3c92066312417d2ef6303de/device/samples/simple_sample_device.js">simple_sample_device.js from azure-iot-sdk-node/device/samples</a>
+to listen on C2D messages as a device. You’ll need to set the <code class="highlighter-rouge">DEVICE_CONNECTION_STRING</code> environment variable to a connection string of the
+device you are using and can run the device with <code class="highlighter-rouge">npm install &amp;&amp; node simple_sample_device.js</code>.</p>
+
+<p>What follows is a sample connection JSON for a connection named <code class="highlighter-rouge">Azure IoT Hub AMPQ</code>, using hostname <code class="highlighter-rouge">my-hub.azure-devices.net</code> and
+shared access policy <code class="highlighter-rouge">service</code> with key <code class="highlighter-rouge">theKey</code>. You can set the correct values from your Azure IoT Hub subscription
+in the fields <code class="highlighter-rouge">uri</code>, <code class="highlighter-rouge">credentials.parameters.sharedKeyName</code>, <code class="highlighter-rouge">credentials.parameters.sharedKey</code> and
+<code class="highlighter-rouge">credentials.parameters.endpoint</code>.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"8caca8c6-10d1-4886-a61f-3ea6270f9d8e"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure IoT Hub AMQP"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"amqp-10"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"amqps://my-hub.azure-devices.net:5671"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+    </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/messages/devicebound"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"iothub-ack"</span><span class="p">:</span><span class="w"> </span><span class="s2">"full"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/devices/{{thing:id}}/messages/devicebound"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+  </span><span class="p">],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"service"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"theKey"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-hub.azure-devices.net"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Instead of applying a payload mapping like in the HTTP example, the connection just sends the ditto protocol live message
+and you should see its content on the device.</p>
+
+<p><code class="highlighter-rouge">POST</code> a message to <code class="highlighter-rouge">&lt;ditto&gt;/api/2/things/ditto:thing/inbox/messages/C2DMessage?timeout=0</code> with content</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"Hello"</span><span class="p">:</span><span class="w"> </span><span class="s2">"from Ditto"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+<p>and see it arrive at the device.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Using the query parameter <code class="highlighter-rouge">timeout=0</code>, you can tell Ditto to not wait for an answer, since
+devices can’t respond to C2D messages.</div>
+
+<h1 id="azure-service-bus">Azure Service Bus</h1>
+
+<p>This example shows how to send a message to an Azure Service Bus via Eclipse Ditto.</p>
+
+<p>For creating signed requests against the Azure Service Bus, you’ll need the following information from your
+Azure IoT Hub instance:</p>
+<ul>
+  <li>A queue (e.g. <code class="highlighter-rouge">my-queue</code>).</li>
+  <li>The hostname (e.g. <code class="highlighter-rouge">my-bus.servicebus.windows.net</code>).</li>
+  <li>The name of a (Azure Service Bus) shared access policy, which has the <code class="highlighter-rouge">Send</code> and <code class="highlighter-rouge">Listen</code> permissions. By default, there
+should be a policy named <code class="highlighter-rouge">RootManageSharedAccessKey</code> which provides this permission (but shouldn’t be used in production
+scenarios).</li>
+  <li>The <code class="highlighter-rouge">Base64</code> encoded primary or secondary key of above policy. The signing will only work if you encode the key with
+<code class="highlighter-rouge">Base64</code> (although it already has <code class="highlighter-rouge">Base64</code> encoding). E.g. if the primary key is <code class="highlighter-rouge">theKey</code>, you need to use its encoded
+version <code class="highlighter-rouge">dGhlS2V5</code>.</li>
+</ul>
+
+<p>What follows is a sample connection JSON for a connection named <code class="highlighter-rouge">Azure Service Bus HTTP</code>, using hostname <code class="highlighter-rouge">my-bus.servicebus.windows.net</code> and
+shared access policy <code class="highlighter-rouge">RootManageSharedAccessKey</code> with encoded key <code class="highlighter-rouge">dGhlS2V5</code> (<code class="highlighter-rouge">theKey</code>). You can set the correct values
+from your Azure Service Bus subscription in the fields <code class="highlighter-rouge">uri</code>, <code class="highlighter-rouge">credentials.parameters.sharedKeyName</code>,
+<code class="highlighter-rouge">credentials.parameters.sharedKey</code> and
+<code class="highlighter-rouge">credentials.parameters.endpoint</code> (which is a combination of the hostname and queue name).</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"adec2846-4d11-4e0a-b456-d8bfc2192fc6"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure Service Bus HTTP"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://my-bus.servicebus.windows.net:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+    </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"POST:/my-queue/messages"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"issuedAcknowledgementLabel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"live-response"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+  </span><span class="p">],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"RootManageSharedAccessKey"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dGhlS2V5"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://my-bus.servicebus.windows.net/my-queue"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>This connection configuration sends live messages to the endpoint at <code class="highlighter-rouge">https://my-hub.servicebus.windows.net.net:443/my-queue/messages</code>
+and signs each request with a <a href="https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas#overview-of-sas">Shared Access Signature</a>.</p>
+
+<h2 id="listen-for-the-message">Listen for the message</h2>
+
+<p>To listen for the message you send into the Service Bus, you can use the Nodejs sample 
+<a href="https://github.com/Azure/azure-sdk-for-js/blob/d7d67ccc865318f3dc6395e0db6997b5af8cf5e8/sdk/servicebus/service-bus/samples/v7/javascript/receiveMessagesStreaming.js">receiveMessagesStreaming.js from azure-sdk-for-js/sdk/servicebus/service-bus/samples/v7/javascript</a>.
+You’ll need to set the <code class="highlighter-rouge">SERVICEBUS_CONNECTION_STRING</code> environment variable to the connection string of the used
+shared access policy. Also, you’ll need to set the <code class="highlighter-rouge">QUEUE_NAME</code> environment variable to the
+used queue (e.g. <code class="highlighter-rouge">my-queue</code>). You should be able to run the sample using <code class="highlighter-rouge">npm install &amp;&amp; node receiveMessagesStreaming.js</code>.</p>
+
+<h2 id="send-a-live-message-to-the-thing-1">Send a live message to the Thing</h2>
+
+<p>To send a message to Service Bus, you can simply send a live message to a Thing. The message
+will be forwarded through your connection <code class="highlighter-rouge">Azure Service Bus HTTP</code> to the Azure Service Bus, from which the sample
+app can read the message.</p>
+
+<p><code class="highlighter-rouge">POST</code> a message to <code class="highlighter-rouge">&lt;ditto&gt;/api/2/things/ditto:thing/inbox/messages/HelloServiceBus</code> with content:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"Hello"</span><span class="p">:</span><span class="w"> </span><span class="s2">"from Ditto"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>If you didn’t change the sample code you should see the message arriving there.</p>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Find details on the different algorithms and their parameters at
+<a href="connectivity-hmac-signing.html">Connectivity API &gt; HMAC request signing</a>.</p>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions regarding this new functionality.</p>
+
+<p><br />
+<br /></p>
+<figure><img class="docimage" src="images/ditto.svg" alt="Ditto" style="max-width: 500px" /></figure>
+
+<p>–<br /> 
+The Eclipse Ditto team</p>
+
+    </div>
+
+
+
+</article>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/404.html b/404.html
index 6d4ec89..ba2fa3a 100644
--- a/404.html
+++ b/404.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1750,7 +1800,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/advanced-data-by-pass.html b/advanced-data-by-pass.html
index ebec708..41f0a3e 100644
--- a/advanced-data-by-pass.html
+++ b/advanced-data-by-pass.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1891,7 +1941,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-overview.html b/architecture-overview.html
index c11c4d1..0406b1c 100644
--- a/architecture-overview.html
+++ b/architecture-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1803,7 +1853,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-concierge.html b/architecture-services-concierge.html
index 8663e1f..fb78b04 100644
--- a/architecture-services-concierge.html
+++ b/architecture-services-concierge.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1789,7 +1839,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-connectivity.html b/architecture-services-connectivity.html
index 7fe5e7f..0cb3965 100644
--- a/architecture-services-connectivity.html
+++ b/architecture-services-connectivity.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1803,7 +1853,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-gateway.html b/architecture-services-gateway.html
index 886644f..842f3f6 100644
--- a/architecture-services-gateway.html
+++ b/architecture-services-gateway.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1782,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-policies.html b/architecture-services-policies.html
index da49e64..168d55c 100644
--- a/architecture-services-policies.html
+++ b/architecture-services-policies.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1782,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-things-search.html b/architecture-services-things-search.html
index 572df43..2e51f24 100644
--- a/architecture-services-things-search.html
+++ b/architecture-services-things-search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1826,7 +1876,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/architecture-services-things.html b/architecture-services-things.html
index cbcbd51..2860a50 100644
--- a/architecture-services-things.html
+++ b/architecture-services-things.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1782,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-acknowledgements.html b/basic-acknowledgements.html
index cae848f..e3cc346 100644
--- a/basic-acknowledgements.html
+++ b/basic-acknowledgements.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2419,7 +2469,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-apis.html b/basic-apis.html
index 326d469..d3eea33 100644
--- a/basic-apis.html
+++ b/basic-apis.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1873,7 +1923,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-auth.html b/basic-auth.html
index c7667f7..6869ecb 100644
--- a/basic-auth.html
+++ b/basic-auth.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1835,7 +1885,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-changenotifications.html b/basic-changenotifications.html
index b175efc..a3314c8 100644
--- a/basic-changenotifications.html
+++ b/basic-changenotifications.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1822,7 +1872,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-connections.html b/basic-connections.html
index 91f3a8b..b488f47 100644
--- a/basic-connections.html
+++ b/basic-connections.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2035,6 +2085,7 @@
   <li><a href="basic-signals-event.html">Thing events</a></li>
   <li><a href="protocol-twinlive.html">Thing live commands/responses/events</a></li>
   <li><a href="protocol-specification-policies-announcement.html">Policy announcements</a></li>
+  <li><a href="protocol-specification-connections-announcement.html">Connection announcements</a></li>
 </ul>
 
 <p>Targets contain:</p>
@@ -2093,6 +2144,12 @@
       <td>✔</td>
       <td>❌</td>
     </tr>
+    <tr>
+      <td>Subscribe for <a href="protocol-specification-connections-announcement.html">Connection announcements</a></td>
+      <td><code class="highlighter-rouge">_/_/connections/announcements</code></td>
+      <td>❌</td>
+      <td>❌</td>
+    </tr>
   </tbody>
 </table>
 
@@ -2152,6 +2209,11 @@
       <td><code class="highlighter-rouge">_/_/policies/announcements</code></td>
       <td>❌</td>
     </tr>
+    <tr>
+      <td>Subscribe for <a href="protocol-specification-connections-announcement.html">Connection announcements</a></td>
+      <td><code class="highlighter-rouge">_/_/connections/announcements</code></td>
+      <td>❌</td>
+    </tr>
   </tbody>
 </table>
 
@@ -2366,7 +2428,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-enrichment.html b/basic-enrichment.html
index 2a1ce4c..1e5165b 100644
--- a/basic-enrichment.html
+++ b/basic-enrichment.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1853,7 +1903,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-errors.html b/basic-errors.html
index 9395ea1..572a696 100644
--- a/basic-errors.html
+++ b/basic-errors.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1824,7 +1874,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-feature.html b/basic-feature.html
index caffd74..8d3375a 100644
--- a/basic-feature.html
+++ b/basic-feature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2003,7 +2053,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-messages.html b/basic-messages.html
index c96519a..c419be0 100644
--- a/basic-messages.html
+++ b/basic-messages.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1881,7 +1931,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-metadata.html b/basic-metadata.html
index db0a12a..36d9b97 100644
--- a/basic-metadata.html
+++ b/basic-metadata.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1939,7 +1989,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-namespaces-and-names.html b/basic-namespaces-and-names.html
index b676844..9142271 100644
--- a/basic-namespaces-and-names.html
+++ b/basic-namespaces-and-names.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1827,7 +1877,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-overview.html b/basic-overview.html
index 0a3ae6e..d46bacf 100644
--- a/basic-overview.html
+++ b/basic-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1807,7 +1857,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-placeholders.html b/basic-placeholders.html
index b32a4b2..6188b24 100644
--- a/basic-placeholders.html
+++ b/basic-placeholders.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2069,7 +2119,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-policy.html b/basic-policy.html
index 0666c64..a796e19 100644
--- a/basic-policy.html
+++ b/basic-policy.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2333,7 +2383,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-rql.html b/basic-rql.html
index 27cc6cb..a83b6bc 100644
--- a/basic-rql.html
+++ b/basic-rql.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2002,7 +2052,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-search.html b/basic-search.html
index ff3bcf7..d27632f 100644
--- a/basic-search.html
+++ b/basic-search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1902,7 +1952,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-announcement.html b/basic-signals-announcement.html
index de5a049..4889faa 100644
--- a/basic-signals-announcement.html
+++ b/basic-signals-announcement.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1765,7 +1815,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-command.html b/basic-signals-command.html
index 096bea1..e4aa817 100644
--- a/basic-signals-command.html
+++ b/basic-signals-command.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1781,7 +1831,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-commandresponse.html b/basic-signals-commandresponse.html
index 8ba3619..b647895 100644
--- a/basic-signals-commandresponse.html
+++ b/basic-signals-commandresponse.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1760,7 +1810,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-errorresponse.html b/basic-signals-errorresponse.html
index 4b0ede9..458cce9 100644
--- a/basic-signals-errorresponse.html
+++ b/basic-signals-errorresponse.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1768,7 +1818,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-event.html b/basic-signals-event.html
index 83d6c91..e468c61 100644
--- a/basic-signals-event.html
+++ b/basic-signals-event.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1767,7 +1817,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals.html b/basic-signals.html
index 69478b1..7b67668 100644
--- a/basic-signals.html
+++ b/basic-signals.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1812,7 +1862,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-thing.html b/basic-thing.html
index 0586073..81b0f9d 100644
--- a/basic-thing.html
+++ b/basic-thing.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1846,7 +1896,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/blog.html b/blog.html
index a66f484..aceb8f3 100644
--- a/blog.html
+++ b/blog.html
@@ -234,6 +234,69 @@
 
         
 
+    <h2><a class="post-link" href="2021-06-17-hmac-credentials.html">Support for HMAC-SHA256 signing for connections</a></h2>
+        <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/9ca96e4eae3d3cf7df52ece39dc0b2fb?s=135" alt="A photo of Florian Fendt" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="https://github.com/ffendt" target="_blank">Florian Fendt</a> </span></span> on <time datetime="2021-06-17T00:00:00+00:00" itemprop="datePublished">Jun 17, 2021</time> - Tags:
+            
+
+                <a href="tag_blog.html">blog</a>, 
+
+                
+
+                <a href="tag_architecture.html">architecture</a>, 
+
+                
+
+                <a href="tag_connectivity.html">connectivity</a>, 
+
+                
+
+                <a href="tag_hmac.html">hmac</a>, 
+
+                
+
+                <a href="tag_azure.html">azure</a>, 
+
+                
+
+                <a href="tag_azure iot hub.html">azure iot hub</a>, 
+
+                
+
+                <a href="tag_azure service bus.html">azure service bus</a>, 
+
+                
+
+                <a href="tag_azure monitor.html">azure monitor</a>, 
+
+                
+
+                <a href="tag_aws sns.html">aws sns</a>, 
+
+                
+
+                <a href="tag_sns.html">sns</a>, 
+
+                
+
+                <a href="tag_aws.html">aws</a>, 
+
+                
+
+                <a href="tag_signing.html">signing</a>, 
+
+                
+
+                <a href="tag_example.html">example</a>
+
+                
+        </span>
+
+        <p> With the upcoming release of Eclipse Ditto version 2.1.0 it will be possible to use HMAC-SHA256 signing for connections. The currently implemented algorithms support you in authenticating requests against:  Azure IoT Hub REST API Azure IoT Hub AMQP 1.0 Azure HTTP Monitor Data Collector API Azure Service Bus REST... </p>
+
+        
+
+        
+
     <h2><a class="post-link" href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></h2>
         <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-05-06T00:00:00+00:00" itemprop="datePublished">May 6, 2021</time> - Tags:
             
@@ -391,21 +454,6 @@
 
         
 
-        
-
-    <h2><a class="post-link" href="2020-10-23-end-2-end-acknowledgment.html">E2E acknowledgment</a></h2>
-        <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d2b4eba8f1c947a3fb94be23d8b82d8b?s=135" alt="A photo of Yannic Klem" style="width:25px;border-radius:50%;display:inline-block;margin:0;margin-right:5px;" /><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name"><a href="https://github.com/Yannic92" target="_blank">Yannic Klem</a> </span></span> on <time datetime="2020-10-23T00:00:00+00:00" itemprop="datePublished">Oct 23, 2020</time> - Tags:
-            
-
-                <a href="tag_blog.html">blog</a>
-
-                
-        </span>
-
-        <p> E2E acknowledgement using Eclipse Ditto By adding the new acknowledgements feature to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1. Previously the connectivity service of Ditto did accept all incoming messages immediately as soon as it received... </p>
-
-        
-
         <p><a href="feed.xml" class="btn btn-primary navbar-btn cursorNorm" role="button">RSS Subscribe</a></p>
 
 <hr />
@@ -431,7 +479,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/blog_archive.html b/blog_archive.html
index 9cc2223..416f4cb 100644
--- a/blog_archive.html
+++ b/blog_archive.html
@@ -236,6 +236,13 @@
         
         <ul class="this">
             
+            <li><time>17 Jun</time><a href="2021-06-17-hmac-credentials.html">Support for HMAC-SHA256 signing for connections</a></li>
+            
+        
+            
+            
+            
+            
             <li><time>06 May</time><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></li>
             
         
@@ -557,7 +564,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-java.html b/client-sdk-java.html
index 229bece..f8173c8 100644
--- a/client-sdk-java.html
+++ b/client-sdk-java.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
         <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Thing could not be created due to: "</span> <span class="o">+</span> <span class="n">throwable</span><span class="o">.</span><span class="na">getMessage</span><span class="o">());</span>
     <span class="o">}</span>
     <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">forId</span><span class="o">(</span><span class="n">thingId</span><span class="o">).</span><span class="na">putAttribute</span><span class="o">(</span><span class="s">"first-updated-at"</span><span class="o">,</span> <span class="n">OffsetDateTime</span><span class="o">.</span><span class="na">now</span><span class="o">().</span><span class="na">toString</span><span class="o">());</span>
-<span class="o">}).</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+<span class="o">}).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <h4 id="subscribe-for-change-notifications">Subscribe for change notifications</h4>
@@ -1824,7 +1874,7 @@
 <p>In order to subscribe for <a href="basic-signals-event.html">events</a> emitted by Ditto after a twin was modified, start the 
 consumption on the <code class="highlighter-rouge">twin</code> channel:</p>
 
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">get</span><span class="o">();</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="k">if</span> <span class="o">(</span><span class="n">change</span><span class="o">.</span><span class="na">getAction</span><span class="o">()</span> <span class="o">==</span> <span class="n">ChangeAction</span><span class="o">.</span><span class="na">CREATED</span><span class="o">)</span> <span class="o">{</span>
@@ -1838,7 +1888,7 @@
 
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"gt(features/temperature/properties/value,23.0)"</span><span class="o">)</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for Twin events"</span><span class="o">);</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForFeaturePropertyChanges</span><span class="o">(</span><span class="s">"my-feature-changes"</span><span class="o">,</span> <span class="s">"temperature"</span><span class="o">,</span> <span class="s">"value"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="c1">// perform custom actions ..</span>
@@ -1852,7 +1902,7 @@
 
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">))</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">registerForThingChanges</span><span class="o">(</span><span class="s">"my-enriched-changes"</span><span class="o">,</span> <span class="n">change</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="n">Optional</span><span class="o">&lt;</span><span class="n">JsonObject</span><span class="o">&gt;</span> <span class="n">extra</span> <span class="o">=</span> <span class="n">change</span><span class="o">.</span><span class="na">getExtra</span><span class="o">();</span>
    <span class="c1">// perform custom actions, making use of the 'extra' data ..</span>
@@ -1864,7 +1914,7 @@
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">(</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">extraFields</span><span class="o">(</span><span class="n">JsonFieldSelector</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="s">"attributes/location"</span><span class="o">)),</span>
    <span class="n">Options</span><span class="o">.</span><span class="na">Consumption</span><span class="o">.</span><span class="na">filter</span><span class="o">(</span><span class="s">"eq(attributes/location,\"kitchen\")"</span><span class="o">)</span>
-<span class="o">).</span><span class="na">get</span><span class="o">();</span>
+<span class="o">).</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 <span class="c1">// register the callbacks...</span>
 </code></pre></div></div>
 
@@ -1872,7 +1922,9 @@
 
 <p>Register for receiving messages with the subject <code class="highlighter-rouge">hello.world</code> on any thing:</p>
 
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">registerForMessage</span><span class="o">(</span><span class="s">"globalMessageHandler"</span><span class="o">,</span> <span class="s">"hello.world"</span><span class="o">,</span> <span class="n">message</span> <span class="o">-&gt;</span> <span class="o">{</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">startConsumption</span><span class="o">().</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Subscribed for live messages/commands/events"</span><span class="o">);</span>
+<span class="n">client</span><span class="o">.</span><span class="na">live</span><span class="o">().</span><span class="na">registerForMessage</span><span class="o">(</span><span class="s">"globalMessageHandler"</span><span class="o">,</span> <span class="s">"hello.world"</span><span class="o">,</span> <span class="n">message</span> <span class="o">-&gt;</span> <span class="o">{</span>
    <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Received Message with subject "</span> <span class="o">+</span>  <span class="n">message</span><span class="o">.</span><span class="na">getSubject</span><span class="o">());</span>
    <span class="n">message</span><span class="o">.</span><span class="na">reply</span><span class="o">()</span>
       <span class="o">.</span><span class="na">statusCode</span><span class="o">(</span><span class="n">HttpStatusCode</span><span class="o">.</span><span class="na">IM_A_TEAPOT</span><span class="o">)</span>
@@ -1897,7 +1949,7 @@
 
 <p>Read a policy:</p>
 <div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">Policy</span> <span class="n">retrievedPolicy</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">retrieve</span><span class="o">(</span><span class="n">PolicyId</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-policy"</span><span class="o">))</span>
-   <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+   <span class="o">.</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <p>Create a policy:</p>
@@ -1909,7 +1961,7 @@
    <span class="o">.</span><span class="na">build</span><span class="o">();</span>
 
 <span class="n">client</span><span class="o">.</span><span class="na">policies</span><span class="o">().</span><span class="na">create</span><span class="o">(</span><span class="n">newPolicy</span><span class="o">)</span>
-   <span class="o">.</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
+   <span class="o">.</span><span class="na">toCompletableFuture</span><span class="o">().</span><span class="na">get</span><span class="o">();</span> <span class="c1">// this will block the thread! work asynchronously whenever possible!</span>
 </code></pre></div></div>
 
 <p>Updating and deleting policies is also possible via the Java client API, please follow the API and the JavaDoc.</p>
@@ -2004,7 +2056,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-javascript.html b/client-sdk-javascript.html
index a74a098..452a7ef 100644
--- a/client-sdk-javascript.html
+++ b/client-sdk-javascript.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1808,7 +1858,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/client-sdk-overview.html b/client-sdk-overview.html
index b564b95..9069190 100644
--- a/client-sdk-overview.html
+++ b/client-sdk-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1763,7 +1813,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-header-mapping.html b/connectivity-header-mapping.html
index 2fce4c5..f36db1e 100644
--- a/connectivity-header-mapping.html
+++ b/connectivity-header-mapping.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1773,7 +1823,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-hmac-signing.html b/connectivity-hmac-signing.html
new file mode 100644
index 0000000..b2bcbdf
--- /dev/null
+++ b/connectivity-hmac-signing.html
@@ -0,0 +1,2464 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="connectivity,  hmac, hmac-sha256, authorization, azure, aws, azure iot hub, azure service bus, azure monitor, aws version 4 signing, aws sns, signing">
+<title>  HMAC signing • Eclipse Ditto™ • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="HMAC signing">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+            <!-- Sidebar Column -->
+            <div class="col-md-3" id="tg-sb-sidebar">
+                
+
+<ul id="mysidebar" class="nav">
+  <li class="sidebarTitle">
+    <label for="docVersion">Eclipse Ditto™ version:</label>
+    <div class="select-wrapper">
+      <select id="docVersion" name="docVersion">
+        
+        <option value="">development</option>
+        
+        <option value="2.0">2.0</option>
+        
+        <option value="1.5">1.5</option>
+        
+        <option value="1.4">1.4</option>
+        
+        <option value="1.3">1.3</option>
+        
+        <option value="1.2">1.2</option>
+        
+        <option value="1.1">1.1</option>
+        
+        <option value="1.0">1.0</option>
+        
+      </select>
+    </div>
+    <div id="dev-warning">
+      <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+    </div>
+  </li>
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Introduction</a>
+          <ul>
+              
+              
+              
+              <li><a href="intro-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-hello-world.html">Hello world</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Release Notes</a>
+          <ul>
+              
+              
+              
+              <li><a href="release_notes_201.html">2.0.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_200.html">2.0.0</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_151.html">1.5.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_150.html">1.5.0</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Archive</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="release_notes_140.html">1.4.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_130.html">1.3.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_121.html">1.2.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_120.html">1.2.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_115.html">1.1.5</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_113.html">1.1.3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_112.html">1.1.2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_111.html">1.1.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_110.html">1.1.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100.html">1.0.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090.html">0.9.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080.html">0.8.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Installation</a>
+          <ul>
+              
+              
+              
+              <li><a href="installation-building.html">Building Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-running.html">Running Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-operating.html">Operating Ditto</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Basic concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="basic-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Model entities</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-thing.html">Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-feature.html">Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-policy.html">Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-metadata.html">Thing Metadata</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-errors.html">Errors</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-signals.html">Signals</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Signal types</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-signals-command.html">Command</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-event.html">Event</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-apis.html">APIs</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-connections.html">Connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-placeholders.html">Placeholders</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-changenotifications.html">Change notifications</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-rql.html">RQL expressions</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Advanced concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Architecture</a>
+          <ul>
+              
+              
+              
+              <li><a href="architecture-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Services</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="architecture-services-policies.html">Policies</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things.html">Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-concierge.html">Concierge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-gateway.html">Gateway</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>HTTP API</a>
+          <ul>
+              
+              
+              
+              <li><a href="httpapi-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-concepts.html">Concepts</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-sse.html">Server sent events</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Connectivity API</a>
+          <ul>
+              
+              
+              
+              <li><a href="connectivity-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+              
+              
+              
+              
+              
+              
+              <li class="active"><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Client SDK</a>
+          <ul>
+              
+              
+              
+              <li><a href="client-sdk-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-java.html">Java</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Ditto Protocol</a>
+          <ul>
+              
+              
+              
+              <li><a href="protocol-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification.html">Specification</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-errors.html">Errors</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-things.html">Things group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/events</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-merge.html">Merge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ search/messages</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-search.html">Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-policies.html">Policies group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-bindings.html">Bindings</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples.html">Examples</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things merge examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Policies examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+    <li><a href="sandbox.html">Sandbox</a></li>
+    
+  
+  
+  
+    
+    <li><a href="presentations.html">Presentations</a></li>
+    
+  
+  
+  
+    
+    <li><a href="glossary.html">Glossary</a></li>
+    
+  
+  
+  
+    
+    <li><a href="feedback.html">Feedback</a></li>
+    
+  
+  
+  
+    
+         <p class="external">
+             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+         </p>
+    
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+</script>
+
+            </div>
+            
+        
+
+        <!-- Content Column -->
+        <div class="col-md-9" id="tg-sb-content">
+            <div class="post-header">
+   <h1 class="post-title-main">HMAC signing</h1>
+</div>
+
+
+
+<div class="post-content">
+
+   
+
+    
+    
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+    
+
+
+    
+
+
+    
+
+  <h2 id="hmac-signing">HMAC signing</h2>
+
+<p>Ditto provides an extensible framework for HMAC-based signing authentication processes for HTTP Push and
+AMQP 1.0 connections. Three algorithms are available out of the box:</p>
+
+<ul>
+  <li><code class="highlighter-rouge">aws4-hmac-sha256</code> (HTTP Push only): <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Version 4 request signing</a> for Amazon Web Services (AWS)</li>
+  <li><code class="highlighter-rouge">az-monitor-2016-04-01</code> (HTTP Push only): <a href="https://docs.microsoft.com/en-us/azure/azure-monitor/logs/data-collector-api#authorization">Version 2016-04-01 request signing</a> for Azure Monitor Data Collector</li>
+  <li><code class="highlighter-rouge">az-sasl</code> (HTTP Push and AMQP 1.0): <a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-dev-guide-sas?tabs=node">Shared Access Signatures</a> for Azure IoT Hub</li>
+  <li><code class="highlighter-rouge">az-sasl</code> (HTTP Push only): <a href="https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas">Shared Access Signatures</a> for Azure Service Bus</li>
+</ul>
+
+<p>To use a request signing algorithm for authentication, set the <code class="highlighter-rouge">credentials</code> field of the connection as follows.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://...:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;algorithm&gt;"</span><span class="p">,</span><span class="w"> </span><span class="err">//</span><span class="w"> </span><span class="err">e.g.</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-monitor-2016-04-01"</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+       </span><span class="err">//</span><span class="w"> </span><span class="err">parameters</span><span class="w"> </span><span class="err">of</span><span class="w"> </span><span class="err">the</span><span class="w"> </span><span class="err">algorithm</span><span class="w"> </span><span class="err">named</span><span class="w"> </span><span class="err">above.</span><span class="w">
+       </span><span class="err">...</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="err">...</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="pre-defined-algorithms">Pre-defined algorithms</h3>
+
+<h4 id="aws4-hmac-sha256">aws4-hmac-sha256</h4>
+
+<p>This algorithm works for AWS SNS and other services using <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Version 4 request signing</a>.</p>
+
+<p>The parameters of the algorithm <code class="highlighter-rouge">aws4-hmac-sha256</code> are:</p>
+<ul>
+  <li><code class="highlighter-rouge">region</code>: Region of the AWS endpoint.</li>
+  <li><code class="highlighter-rouge">service</code>: Service name of the AWS endpoint.</li>
+  <li><code class="highlighter-rouge">accessKey</code>: Access key of the signing user.</li>
+  <li><code class="highlighter-rouge">secretKey</code>: Secret key of the signing user.</li>
+  <li><code class="highlighter-rouge">doubleEncode</code>: Whether to double-encode and normalize path segments during request signing. Should be <code class="highlighter-rouge">false</code> for S3 and <code class="highlighter-rouge">true</code> for other services. Defaults to <code class="highlighter-rouge">true</code>.</li>
+  <li><code class="highlighter-rouge">canonicalHeaders</code>: Array of names of headers to include in the signature. Default to <code class="highlighter-rouge">["host"]</code>.</li>
+  <li><code class="highlighter-rouge">xAmzContentSha256</code>: Configuration for the header <code class="highlighter-rouge">x-amz-content-sha256</code>, which is mandatory for S3. Possible values are:
+    <ul>
+      <li><code class="highlighter-rouge">EXCLUDED</code>: Do not send the header for non-S3 services. This is the default.</li>
+      <li><code class="highlighter-rouge">INCLUDED</code>: Sign the payload hash as the value of the header for S3.</li>
+      <li><code class="highlighter-rouge">UNSIGNED</code>: Omit the payload hash in the signature for S3.</li>
+    </ul>
+  </li>
+</ul>
+
+<h4 id="az-monitor-2016-04-01">az-monitor-2016-04-01</h4>
+
+<p>This algorithm works for <a href="https://docs.microsoft.com/en-us/azure/azure-monitor/logs/data-collector-api#authorization">Version 2016-04-01 request signing</a>
+for Azure Monitor Data Collector.</p>
+
+<p>The parameters of the algorithm <code class="highlighter-rouge">az-monitor-2016-04-01</code> are:</p>
+<ul>
+  <li><code class="highlighter-rouge">workspaceId</code>: ID of the Azure Monitor workspace.</li>
+  <li><code class="highlighter-rouge">sharedKey</code>: Primary or secondary key of the Azure Monitor workspace.</li>
+</ul>
+
+<h4 id="az-sasl">az-sasl</h4>
+
+<p>This algorithm works for Azure IoT Hub (HTTP and AMQP) <a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-dev-guide-sas?tabs=node">Shared Access Signatures</a>
+and Azure Service Bus (HTTP) <a href="https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas">Shared Access Signatures</a>.</p>
+
+<p>The parameters of the algorithm <code class="highlighter-rouge">az-sasl</code> are:</p>
+<ul>
+  <li><code class="highlighter-rouge">sharedKeyName</code>: Name of the used <code class="highlighter-rouge">sharedKey</code>.</li>
+  <li><code class="highlighter-rouge">sharedKey</code>: Primary or secondary key of <code class="highlighter-rouge">sharedKeyName</code>. The key for Azure Service Bus needs an additional
+<code class="highlighter-rouge">Base64</code> encoding to work (e.g. a primary key <code class="highlighter-rouge">theKey</code> should be encoded to <code class="highlighter-rouge">dGhlS2V5</code> and used in this format).</li>
+  <li><code class="highlighter-rouge">endpoint</code>: The endpoint which is used in the signature. For Azure IoT Hub this is expected
+to be the <code class="highlighter-rouge">resourceUri</code> without protocol (e.g. <code class="highlighter-rouge">myHub.azure-devices.net</code>, see the respective Azure documentation).
+For Azure Service Bus, this is expected to be the full URI of the resource to which access
+is claimed (e.g. <code class="highlighter-rouge">https://myNamespaces.servicebus.windows.net/myQueue</code>, see the respective Azure documentation)</li>
+  <li><code class="highlighter-rouge">ttl</code> (optional): The time to live of a signature as a string in duration format. Allowed time units are “ms” (milliseconds),
+“s” (seconds), “m” (minutes) and “h” (hours), e.g. “10m” for ten minutes.
+<code class="highlighter-rouge">ttl</code> should only be set for AMQP connections and defines how long the connection signing is valid.
+The broker (e.g. Azure IoT Hub) will close the connection after <code class="highlighter-rouge">ttl</code> and Ditto will reconnect with a new signature.
+Defaults to 7 days.</li>
+</ul>
+
+<h3 id="supported-connection-types">Supported connection types</h3>
+
+<table>
+  <thead>
+    <tr>
+      <th> </th>
+      <th>HTTP Push connection</th>
+      <th>AMQP 1.0 connection</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code class="highlighter-rouge">aws-hmac-sha256</code></td>
+      <td>✓</td>
+      <td> </td>
+    </tr>
+    <tr>
+      <td><code class="highlighter-rouge">az-monitor-2016-04-01</code></td>
+      <td>✓</td>
+      <td> </td>
+    </tr>
+    <tr>
+      <td><code class="highlighter-rouge">az-sasl</code></td>
+      <td>✓</td>
+      <td>✓ (for Azure IoT Hub)</td>
+    </tr>
+  </tbody>
+</table>
+
+<h3 id="configuration">Configuration</h3>
+
+<p>Algorithm names and implementations are configured in <a href="https://github.com/eclipse/ditto/blob/master/connectivity/service/src/main/resources/connectivity.conf"><code class="highlighter-rouge">connectivity.conf</code></a>.
+The default configuration provides the names and implementations of the available pre-defined algorithms for the given
+connection types.</p>
+<pre><code class="language-hocon">ditto.connectivity.connection {
+  http-push.hmac-algorithms = {
+
+    aws4-hmac-sha256 =
+      "org.eclipse.ditto.connectivity.service.messaging.httppush.AwsRequestSigningFactory"
+
+    az-monitor-2016-04-01 =
+      "org.eclipse.ditto.connectivity.service.messaging.httppush.AzMonitorRequestSigningFactory"
+
+    az-sasl =
+      "org.eclipse.ditto.connectivity.service.messaging.signing.AzSaslSigningFactory"
+
+    // my-own-request-signing-algorithm =
+    //   "my.package.MyOwnImplementationOfHttpRequestSigningFactory"
+  }
+  amqp10.hmac-algorithms = {
+
+    az-sasl =
+      "org.eclipse.ditto.connectivity.service.messaging.signing.AzSaslSigningFactory"
+
+    // my-own-connection-signing-algorithm =
+    //   "my.package.MyOwnImplementationOfAmqpConnectionSigningFactory"
+  }
+}
+</code></pre>
+
+<p>Users may add own request signing algorithms by implementing a defined interface and providing the fully
+qualified class name of the implementation in the config. The following table provides information where to update the configuration
+and which interface needs to be implemented.</p>
+
+<table>
+  <thead>
+    <tr>
+      <th> </th>
+      <th>HTTP Push connection</th>
+      <th>AMQP 1.0 connection</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Config path</td>
+      <td><code class="highlighter-rouge">ditto.connectivity.connection.http-push.hmac-algorithms</code></td>
+      <td><code class="highlighter-rouge">ditto.connectivity.connection.amqp10.hmac-algorithms</code></td>
+    </tr>
+    <tr>
+      <td>Class to implement</td>
+      <td><a href="https://github.com/eclipse/ditto/blob/master/connectivity/service/src/main/java/org/eclipse/ditto/connectivity/service/messaging/httppush/HttpRequestSigningFactory.java">HttpRequestSigningFactory</a></td>
+      <td><a href="https://github.com/eclipse/ditto/blob/master/connectivity/service/src/main/java/org/eclipse/ditto/connectivity/service/messaging/amqp/AmqpConnectionSigningFactory.java">AmqpConnectionSigningFactory</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<h3 id="example-integrations">Example integrations</h3>
+
+<h4 id="aws-sns">AWS SNS</h4>
+
+<p>This example is an HTTP connection to <a href="https://aws.amazon.com/sns/">AWS SNS (Simple Notification Service)</a> publishing
+twin events as messages to an SNS topic. Prerequisites are:</p>
+<ul>
+  <li>An IAM user with access to SNS,</li>
+  <li>An SNS topic,</li>
+  <li>A subscription on the SNS topic to receive twin events, e.g. by email.</li>
+</ul>
+
+<p>The SNS connection is shown below.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AWS SNS"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://sns.&lt;aws-region&gt;.amazonaws.com:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"aws4-hmac-sha256"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"region"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-region&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="s2">"sns"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"accessKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-access-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"secretKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-secret-key&gt;"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+      </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"GET:/"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"_/_/things/twin/events"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"integration:ditto"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+      </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"javascript"</span><span class="w"> </span><span class="p">]</span><span class="w">
+  </span><span class="p">}],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"mappingDefinitions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"javascript"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"mappingEngine"</span><span class="p">:</span><span class="w"> </span><span class="s2">"JavaScript"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"options"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"incomingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapToDittoProtocolMsg() {</span><span class="se">\n</span><span class="s2">    return undefined;</span><span class="se">\n</span><span class="s2">}"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"outgoingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapFromDittoProtocolMsg(namespace,name,group,channel,criterion,action,path,dittoHeaders,value,status,extra) {</span><span class="se">\n</span><span class="s2">  let textPayload = JSON.stringify(Ditto.buildDittoProtocolMsg(namespace, name, group, channel, criterion, action, path, dittoHeaders, value, status, extra));</span><span class="se">\n</span><span class="s2">  let query = 'Action=Publish&amp;Message=' + encodeURIComponent(textPayload) + '&amp;Subject=ThingModified&amp;TopicArn=&lt;sns-topic-arn&gt;';</span><span class="se">\n</span><span class="s2">  let headers = {</span><span class="se">\"</span><span class="s2">http.query</span><span class="se">\"</span><span class="s2">:query};</span><span class="se">\n</span><span class="s2">  return Ditto.buildExternalMsg(headers,'',null,'text/plain');</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadBytebufferJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadLongJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;aws-region&gt;</code>: The region of the SNS service.</li>
+  <li><code class="highlighter-rouge">&lt;aws-access-key&gt;</code> The access key of the user authorized for SNS.</li>
+  <li><code class="highlighter-rouge">&lt;aws-secret-key&gt;</code> The secret key of the user authorized for SNS.</li>
+  <li><code class="highlighter-rouge">&lt;sns-topic-arn&gt;</code> The ARN of the SNS topic. Note that it is a part of the URI and every <code class="highlighter-rouge">:</code> needs to be encoded as
+<code class="highlighter-rouge">%3A</code>.</li>
+</ul>
+
+<p>Here is the outgoing payload mapping in a readable format.
+Since the HTTP API of SNS requires GET requests with all necessary information in
+the query parameters, the payload mapper computes the query string and sets it via
+the <a href="connectivity-protocol-bindings-http.html#target-header-mapping">special header</a> <code class="highlighter-rouge">http.query</code>.
+It is important to set payload to <code class="highlighter-rouge">null</code> so that the HMAC
+signature is computed from the SHA256 hash of the empty string, which SNS expects.</p>
+<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span><span class="nx">name</span><span class="p">,</span><span class="nx">group</span><span class="p">,</span><span class="nx">channel</span><span class="p">,</span><span class="nx">criterion</span><span class="p">,</span>
+                                 <span class="nx">action</span><span class="p">,</span><span class="nx">path</span><span class="p">,</span><span class="nx">dittoHeaders</span><span class="p">,</span><span class="nx">value</span><span class="p">,</span><span class="nx">status</span><span class="p">,</span><span class="nx">extra</span><span class="p">)</span> <span class="p">{</span>
+  <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</span><span class="p">,</span>
+      <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">,</span> <span class="nx">path</span><span class="p">,</span> <span class="nx">dittoHeaders</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="nx">status</span><span class="p">,</span> <span class="nx">extra</span><span class="p">));</span>
+  <span class="kd">let</span> <span class="nx">query</span> <span class="o">=</span> <span class="s1">'Action=Publish&amp;Message='</span> <span class="o">+</span> <span class="nb">encodeURIComponent</span><span class="p">(</span><span class="nx">textPayload</span><span class="p">)</span> <span class="o">+</span>
+      <span class="s1">'&amp;Subject=ThingModified&amp;TopicArn=&lt;sns-topic-arn&gt;'</span><span class="p">;</span>
+  <span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="p">{</span> <span class="s2">"http.query"</span><span class="p">:</span> <span class="nx">query</span> <span class="p">};</span>
+  <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span><span class="nx">headers</span><span class="p">,</span> <span class="s1">''</span><span class="p">,</span> <span class="kc">null</span><span class="p">,</span> <span class="s1">'text/plain'</span><span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<h4 id="aws-s3">AWS S3</h4>
+
+<p>This example is an HTTP connection to <a href="https://aws.amazon.com/s3/">AWS S3 (Simple Storage Service)</a> publishing
+twin events as objects in an S3 bucket. Prerequisites are:</p>
+<ul>
+  <li>An IAM user with access to S3,</li>
+  <li>An S3 bucket.</li>
+</ul>
+
+<p>The S3 connection is shown below. The credentials parameter <code class="highlighter-rouge">"xAmzContentSha256": "INCLUDED"</code> is necessary in order
+to include the payload hash as the value of the header <code class="highlighter-rouge">x-amz-content-sha256</code>. In addition,
+the parameter <code class="highlighter-rouge">"doubleEncode"</code> must be set to <code class="highlighter-rouge">false</code> because S3 performs URI-encoding only once when computing
+the signature, in contrast to other AWS services where the path segments of HTTP requests are encoded twice.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"AWS S3"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://&lt;s3-bucket&gt;.s3.&lt;aws-region&gt;.amazonaws.com:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"aws4-hmac-sha256"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"region"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-region&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="s2">"s3"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"accessKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-access-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"secretKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;aws-secret-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"doubleEncode"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"canonicalHeaders"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"host"</span><span class="p">,</span><span class="w"> </span><span class="s2">"x-amz-date"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"xAmzContentSha256"</span><span class="p">:</span><span class="w"> </span><span class="s2">"INCLUDED"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+      </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"PUT:/"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"_/_/things/twin/events"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"integration:ditto"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+      </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+        </span><span class="s2">"javascript"</span><span class="w">
+      </span><span class="p">]</span><span class="w">
+  </span><span class="p">}],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"mappingDefinitions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"javascript"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"mappingEngine"</span><span class="p">:</span><span class="w"> </span><span class="s2">"JavaScript"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"options"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"incomingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapToDittoProtocolMsg() {</span><span class="se">\n</span><span class="s2">  return undefined;</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"outgoingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapFromDittoProtocolMsgWrapper(msg) {</span><span class="se">\n</span><span class="s2">  let topic = msg['topic'].split('/').join(':');</span><span class="se">\n</span><span class="s2">  let headers = {</span><span class="se">\n</span><span class="s2">      'http.path': topic+':'+msg['revision']</span><span class="se">\n</span><span class="s2">  };</span><span class="se">\n</span><span class="s2">  let textPayload = JSON.stringify(msg);</span><span class="se">\n</span><span class="s2">  let bytePayload = null;</span><span class="se">\n</span><span class="s2">  let contentType = 'application/json';</span><span class="se">\n\n</span><span class="s2">  return Ditto.buildExternalMsg(</span><span class="se">\n</span><span class="s2">    headers,</span><span class="se">\n</span><span class="s2">    textPayload,</span><span class="se">\n</span><span class="s2">    bytePayload,</span><span class="se">\n</span><span class="s2">    contentType</span><span class="se">\n</span><span class="s2">  );</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadBytebufferJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadLongJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;s3-bucket&gt;</code>: Name of the S3 bucket.</li>
+  <li><code class="highlighter-rouge">&lt;aws-region&gt;</code>: The region of the S3 service.</li>
+  <li><code class="highlighter-rouge">&lt;aws-access-key&gt;</code> The access key of the user authorized for S3.</li>
+  <li><code class="highlighter-rouge">&lt;aws-secret-key&gt;</code> The secret key of the user authorized for S3.</li>
+</ul>
+
+<p>In order to create a distinct object for each event,
+the payload mapper that computes the path string and sets it via
+the <a href="connectivity-protocol-bindings-http.html#target-header-mapping">special header</a> <code class="highlighter-rouge">http.path</code>.
+The mapper overrides the function <code class="highlighter-rouge">mapFromDittoProtocolMsgWrapper</code> instead of the usual
+<code class="highlighter-rouge">mapFromDittoProtocolMsg</code> so that it has access to the revision number of twin events.
+The value of <code class="highlighter-rouge">http.path</code> is the name of the object, which consists of the topic of the event with <code class="highlighter-rouge">/</code> replaced by <code class="highlighter-rouge">:</code>
+followed by its revision. For example, a thing-modified event of revision 42 generates the object
+<code class="highlighter-rouge">&lt;namespace&gt;:&lt;name&gt;:things:twin:events:modified:42</code>.</p>
+
+<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsgWrapper</span><span class="p">(</span><span class="nx">msg</span><span class="p">)</span> <span class="p">{</span>
+  <span class="kd">let</span> <span class="nx">topic</span> <span class="o">=</span> <span class="nx">msg</span><span class="p">[</span><span class="s1">'topic'</span><span class="p">].</span><span class="nx">split</span><span class="p">(</span><span class="s1">'/'</span><span class="p">).</span><span class="nx">join</span><span class="p">(</span><span class="s1">':'</span><span class="p">);</span>
+  <span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="p">{</span>
+      <span class="s1">'http.path'</span><span class="p">:</span> <span class="nx">topic</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span> <span class="nx">msg</span><span class="p">[</span><span class="s1">'revision'</span><span class="p">]</span>
+  <span class="p">};</span>
+  <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nx">msg</span><span class="p">);</span>
+  <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+  <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/json'</span><span class="p">;</span>
+
+  <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
+    <span class="nx">headers</span><span class="p">,</span>
+    <span class="nx">textPayload</span><span class="p">,</span>
+    <span class="nx">bytePayload</span><span class="p">,</span>
+    <span class="nx">contentType</span>
+  <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<h4 id="azure-monitor-data-collector-http-api">Azure Monitor Data Collector HTTP API</h4>
+
+<p>This example is an HTTP connection pushing twin events into
+<a href="https://docs.microsoft.com/en-us/azure/azure-monitor/logs/data-collector-api">Azure Monitor Data Collector API</a>.
+It requires an Azure Log Analytics Workspace.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure Monitor"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://&lt;workspace-id&gt;.ods.opinsights.azure.com:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-monitor-2016-04-01"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"workspaceId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;workspace-id&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-key&gt;"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+      </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"POST:/api/logs?api-version=2016-04-01"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"_/_/things/twin/events"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"integration:ditto"</span><span class="w"> </span><span class="p">],</span><span class="w">
+      </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"Content-Type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/json"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"Log-Type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"TwinEvent"</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+  </span><span class="p">}],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;workspace-id&gt;</code>: The ID of the log analytics workspace.</li>
+  <li><code class="highlighter-rouge">&lt;shared-key&gt;</code>: The primary or secondary shared key of the log analytics workspace.</li>
+</ul>
+
+<p>The connection publishes all fields of all twin events under the log type <code class="highlighter-rouge">TwinEvent</code>. After a maximum of 30 minutes
+after the first event, Azure Monitor should have created a custom log type <code class="highlighter-rouge">TwinEvent_CL</code> containing a twin event
+in each row.</p>
+
+<h4 id="azure-iot-hub-http-api">Azure IoT Hub HTTP API</h4>
+
+<p>What follows is an example of a connection which forwards live messages sent to things as direct method calls to
+<a href="https://docs.microsoft.com/en-us/azure/iot-hub/about-iot-hub">Azure IoT Hub</a> via HTTP. You’ll receive the response of the direct method call.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure IoT Hub HTTP"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://&lt;hostname&gt;:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+    </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"POST:/twins/{{ thing:id }}/methods?api-version=2018-06-30"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"issuedAcknowledgementLabel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"live-response"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
+    </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"javascript"</span><span class="p">]</span><span class="w">
+  </span><span class="p">}],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"mappingDefinitions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"javascript"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"mappingEngine"</span><span class="p">:</span><span class="w"> </span><span class="s2">"JavaScript"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"options"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"incomingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapToDittoProtocolMsg() {</span><span class="se">\n</span><span class="s2">  return undefined;</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"outgoingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">"function mapFromDittoProtocolMsg(</span><span class="se">\n</span><span class="s2">  namespace,</span><span class="se">\n</span><span class="s2">  name,</span><span class="se">\n</span><span class="s2">  group,</span><span class="se">\n</span><span class="s2">  channel,</span><span class="se">\n</span><span class="s2">  criterion,</span><span class="se">\n</span><span class="s2">  action,</span><span class="se">\n</span><span class="s2">  path,</span><span class="se">\n</span><span class="s2">  dittoHeaders,</span><span class="se">\n</span><span class="s2">  value,</span><span class="se">\n</span><span class="s2">  status,</span><span class="se">\n</span><span class="s2">  extra</span><span class="se">\n</span><span class="s2">) {</span><span class="se">\n\n</span><span class="s2">  let headers = dittoHeaders;</span><span class="se">\n</span><span class="s2">  let payload = {</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">methodName</span><span class="se">\"</span><span class="s2">: action,</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">responseTimeoutInSeconds</span><span class="se">\"</span><span class="s2">: parseInt(dittoHeaders.timeout),</span><span class="se">\n</span><span class="s2">      </span><span class="se">\"</span><span class="s2">payload</span><span class="se">\"</span><span class="s2">: value</span><span class="se">\n</span><span class="s2">  };</span><span class="se">\n</span><span class="s2">  let textPayload = JSON.stringify(payload);</span><span class="se">\n</span><span class="s2">  let bytePayload = null;</span><span class="se">\n</span><span class="s2">  let contentType = 'application/json';</span><span class="se">\n\n</span><span class="s2">  return Ditto.buildExternalMsg(</span><span class="se">\n</span><span class="s2">    headers, // The external headers Object containing header values</span><span class="se">\n</span><span class="s2">    textPayload, // The external mapped String</span><span class="se">\n</span><span class="s2">    bytePayload, // The external mapped byte[]</span><span class="se">\n</span><span class="s2">    contentType // The returned Content-Type</span><span class="se">\n</span><span class="s2">  );</span><span class="se">\n</span><span class="s2">}</span><span class="se">\n</span><span class="s2">"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadBytebufferJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"loadLongJS"</span><span class="p">:</span><span class="w"> </span><span class="s2">"false"</span><span class="w">
+      </span><span class="p">}</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-access-policy-name&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-access-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;hostname&gt;"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;hostname&gt;</code>: The hostname of your iot hub instance. E.g. <code class="highlighter-rouge">my-hub.azure-devices.net</code>.</li>
+  <li><code class="highlighter-rouge">&lt;shared-access-policy-name&gt;</code>: The name of the (Azure IoT Hub) shared access policy, which has the <code class="highlighter-rouge">Service connect</code> permission. E.g. <code class="highlighter-rouge">service</code>.</li>
+  <li><code class="highlighter-rouge">&lt;shared-access-key&gt;</code>: The primary or secondary key of above policy. E.g. <code class="highlighter-rouge">theKey</code>.</li>
+</ul>
+
+<p>The <code class="highlighter-rouge">outgoingScript</code> provides JavaScript payload mapping which maps the outgoing ditto protocol message into
+the required <a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-direct-methods#invoke-a-direct-method-from-a-back-end-app">direct method format</a>.
+I.e. it uses the live message subject as <code class="highlighter-rouge">methodName</code>, the timeout as <code class="highlighter-rouge">responseTimeoutInSeconds</code> and the value as <code class="highlighter-rouge">payload</code>:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span>
+        <span class="nx">namespace</span><span class="p">,</span>
+        <span class="nx">name</span><span class="p">,</span>
+        <span class="nx">group</span><span class="p">,</span>
+        <span class="nx">channel</span><span class="p">,</span>
+        <span class="nx">criterion</span><span class="p">,</span>
+        <span class="nx">action</span><span class="p">,</span>
+        <span class="nx">path</span><span class="p">,</span>
+        <span class="nx">dittoHeaders</span><span class="p">,</span>
+        <span class="nx">value</span><span class="p">,</span>
+        <span class="nx">status</span><span class="p">,</span>
+        <span class="nx">extra</span>
+<span class="p">)</span> <span class="p">{</span>
+
+  <span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
+  <span class="kd">let</span> <span class="nx">payload</span> <span class="o">=</span> <span class="p">{</span>
+    <span class="s2">"methodName"</span><span class="p">:</span> <span class="nx">action</span><span class="p">,</span>
+    <span class="s2">"responseTimeoutInSeconds"</span><span class="p">:</span> <span class="nb">parseInt</span><span class="p">(</span><span class="nx">dittoHeaders</span><span class="p">.</span><span class="nx">timeout</span><span class="p">),</span>
+    <span class="s2">"payload"</span><span class="p">:</span> <span class="nx">value</span>
+  <span class="p">};</span>
+  <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nx">payload</span><span class="p">);</span>
+  <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+  <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/json'</span><span class="p">;</span>
+
+  <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
+    <span class="nx">headers</span><span class="p">,</span>
+    <span class="nx">textPayload</span><span class="p">,</span>
+    <span class="nx">bytePayload</span><span class="p">,</span>
+    <span class="nx">contentType</span>
+  <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>This is required since Azure IoT Hub direct methods require a specific format:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+    </span><span class="s2">"methodName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"reboot"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"responseTimeoutInSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">200</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"payload"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+        </span><span class="s2">"input1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"someInput"</span><span class="p">,</span><span class="w">
+        </span><span class="s2">"input2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"anotherInput"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Send live messages to a Thing, which contain as value the expected <code class="highlighter-rouge">payload</code>, as live message subject the expected
+<code class="highlighter-rouge">methodName</code> and as timeout the expected <code class="highlighter-rouge">responseTimeoutInSeconds</code>. Then they can successfully invoke
+the direct method on their respective devices.</p>
+
+<p>E.g. a live message for the above direct method would be a <code class="highlighter-rouge">POST</code> to
+<code class="highlighter-rouge">&lt;ditto&gt;/api/2/things/&lt;thing-id&gt;/inbox/messages/reboot?timeout=200s</code> with body:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+    </span><span class="s2">"input1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"someInput"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"input2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"anotherInput"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="azure-iot-hub-amqp-api">Azure IoT Hub AMQP API</h4>
+
+<p>What follows is an example of a connections which forwards live messages sent to things as Cloud To Device (C2D)
+messages to <a href="https://docs.microsoft.com/en-us/azure/iot-hub/about-iot-hub">Azure IoT Hub</a> via AMQP 1.0.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure IoT Hub AMQP"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"amqp-10"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"amqps://&lt;hostname&gt;:5671"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+    </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/messages/devicebound"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"iothub-ack"</span><span class="p">:</span><span class="w"> </span><span class="s2">"full"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/devices/{{thing:id}}/messages/devicebound"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+  </span><span class="p">],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-access-policy-name&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-access-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;hostname&gt;"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;hostname&gt;</code>: The hostname of your iot hub instance. E.g. <code class="highlighter-rouge">my-hub.azure-devices.net</code>.</li>
+  <li><code class="highlighter-rouge">&lt;shared-access-policy-name&gt;</code>: The name of the (Azure IoT Hub) shared access policy, which has the <code class="highlighter-rouge">Service connect</code> permission. E.g. <code class="highlighter-rouge">service</code>.</li>
+  <li><code class="highlighter-rouge">&lt;shared-access-key&gt;</code>: The primary or secondary key of above policy. E.g. <code class="highlighter-rouge">theKey</code>.</li>
+</ul>
+
+<h4 id="azure-service-bus-http-api">Azure Service Bus HTTP API</h4>
+
+<p>What follows is an example of a connection which forwards live messages sent to things to a queue in
+<a href="https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-overview">Azure Service Bus</a>.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"00000000-0000-0000-0000-000000000000"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Azure Service Bus HTTP"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http-push"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"connectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="s2">"open"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://&lt;hostname&gt;:443"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"sources"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w">
+  </span><span class="s2">"targets"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+    </span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"POST:/&lt;queue-name&gt;/messages"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"topics"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"_/_/things/live/messages"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"authorizationContext"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"integration:ditto"</span><span class="p">],</span><span class="w">
+    </span><span class="s2">"issuedAcknowledgementLabel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"live-response"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+  </span><span class="p">],</span><span class="w">
+  </span><span class="s2">"clientCount"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"failoverEnabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"validateCertificates"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"processorPoolSize"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"specificConfig"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"parallelism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"credentials"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hmac"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"algorithm"</span><span class="p">:</span><span class="w"> </span><span class="s2">"az-sasl"</span><span class="p">,</span><span class="w">
+    </span><span class="s2">"parameters"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+      </span><span class="s2">"sharedKeyName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;shared-access-policy-name&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"sharedKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"&lt;base64-encoded-shared-key&gt;"</span><span class="p">,</span><span class="w">
+      </span><span class="s2">"endpoint"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://&lt;hostname&gt;/&lt;queue-name&gt;"</span><span class="w">
+    </span><span class="p">}</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Parameters:</p>
+<ul>
+  <li><code class="highlighter-rouge">&lt;hostname&gt;</code>: The hostname of your service bus instance. E.g. <code class="highlighter-rouge">my-bus.servicebus.windows.net</code>.</li>
+  <li><code class="highlighter-rouge">&lt;queue-name&gt;</code>: The queue name to which you want to publish in your service bus instance. E.g. <code class="highlighter-rouge">my-queue</code>’.</li>
+  <li><code class="highlighter-rouge">&lt;shared-access-policy-name&gt;</code>: The name of the (Azure Service Bus) shared access policy, which has <code class="highlighter-rouge">Send</code> and <code class="highlighter-rouge">Listen</code> permissions. E.g. <code class="highlighter-rouge">RootManageSharedAccessKey</code>.</li>
+  <li><code class="highlighter-rouge">&lt;base64-encoded-shared-key&gt;</code>: The <code class="highlighter-rouge">Base64</code> encoded primary or secondary key of above policy. The signing work if you
+encode the key with <code class="highlighter-rouge">Base64</code> (although it already has <code class="highlighter-rouge">Base64</code> encoding). E.g. if the primary key is <code class="highlighter-rouge">theKey</code>, you need to use
+its encoded version <code class="highlighter-rouge">dGhlS2V5</code>.</li>
+</ul>
+
+
+    <div class="tags">
+        
+        <b>Tags: </b>
+        
+        
+        
+        <a href="tag_connectivity.html" class="btn btn-default navbar-btn cursorNorm" role="button">connectivity</a>
+        
+        
+        
+    </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/connectivity-manage-connections.html b/connectivity-manage-connections.html
index 7b788bd..e563bdf 100644
--- a/connectivity-manage-connections.html
+++ b/connectivity-manage-connections.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1814,7 +1864,8 @@
 
 <h3 id="open-connection">Open connection</h3>
 
-<p>The only parameter necessary for opening a connection is the <code class="highlighter-rouge">connectionId</code>.</p>
+<p>The only parameter necessary for opening a connection is the <code class="highlighter-rouge">connectionId</code>. When opening a connection a 
+<a href="protocol-specification-connections-announcement.html">ConnectionOpenedAnnouncement</a> will be published.</p>
 
 <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
   </span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</span><span class="p">,</span><span class="w">
@@ -1830,7 +1881,8 @@
 
 <h3 id="close-connection">Close connection</h3>
 
-<p>The only parameter necessary for closing a connection is the <code class="highlighter-rouge">connectionId</code>.</p>
+<p>The only parameter necessary for closing a connection is the <code class="highlighter-rouge">connectionId</code>. When gracefully closing a connection a
+<a href="protocol-specification-connections-announcement.html">ConnectionClosedAnnouncement</a> will be published.</p>
 
 <div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
   </span><span class="s2">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</span><span class="p">,</span><span class="w">
@@ -2104,7 +2156,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-mapping.html b/connectivity-mapping.html
index 61c84e2..ab64a91 100644
--- a/connectivity-mapping.html
+++ b/connectivity-mapping.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2149,33 +2199,54 @@
 
 <div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
  * Builds a Ditto Protocol message from the passed parameters.
- * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
- * @param {string} name - The name of the entity, e.g.: "device"
- * @param {string} group - The affected group/entity, one of: "things"
- * @param {string} channel - The channel for the signal, one of: "twin"|"live"
- * @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
- * @param {string} action - The action to perform, one of: "create"|"retrieve"|"modify"|"delete"
- * @param {string} path - The path which is affected by the message, e.g.: "/attributes"
- * @param {Object.&lt;string, string&gt;} dittoHeaders - The headers Object containing all Ditto Protocol header values
- * @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action)
+ * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto". Or "_"
+ * (underscore) for connection announcements.
+ * @param {string} name - The name of the entity, e.g.: "device".
+ * @param {string} channel - The channel for the signal: "twin"|"live"|"none"
+ * @param {string} group - The affected group/entity: "things"|"policies"|"connections".
+ * @param {string} criterion - The criterion to apply: "commands"|"events"|"search"|"messages"|"announcements"|"errors".
+ * @param {string} action - The action to perform: "create"|"retrieve"|"modify"|"delete". Or the announcement name:
+ * "opened"|"closed"|"subjectDeletion". Or the subject of the message.
+ * @param {string} path - The path which is affected by the message (e.g.: "/attributes"), or the destination
+ * of a message (e.g.: "inbox"|"outbox").
+ * @param {Object.&lt;string, string&gt;} dittoHeaders - The headers Object containing all Ditto Protocol header values.
+ * @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action).
  * @param {number} [status] - The status code that indicates the result of the command. If setting a status code,
  * the Ditto Protocol Message will be interpreted as a response (e.g. content will be ignored when using 204).
  * @param {Object} [extra] - The enriched extra fields when selected via "extraFields" option.
- * @returns {DittoProtocolMessage} dittoProtocolMessage - 
- *  the mapped Ditto Protocol message or 
+ * @returns {DittoProtocolMessage} dittoProtocolMessage(s) -
+ *  The mapped Ditto Protocol message or
  *  &lt;code&gt;null&lt;/code&gt; if the message could/should not be mapped
  */</span>
-<span class="kd">function</span> <span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">,</span> 
-                               <span class="nx">path</span><span class="p">,</span> <span class="nx">dittoHeaders</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="nx">status</span><span class="p">,</span> <span class="nx">extra</span><span class="p">)</span> <span class="p">{</span>
+<span class="kd">function</span> <span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">,</span> <span class="nx">path</span><span class="p">,</span> <span class="nx">dittoHeaders</span><span class="p">,</span> <span class="nx">value</span><span class="p">,</span> <span class="nx">status</span><span class="p">,</span> <span class="nx">extra</span><span class="p">)</span> <span class="p">{</span>
+    <span class="kd">const</span> <span class="nx">topic</span> <span class="o">=</span> <span class="nx">buildTopic</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">);</span>
 
-  <span class="k">return</span> <span class="p">{</span>
-    <span class="na">topic</span><span class="p">:</span> <span class="nx">namespace</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">name</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">group</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">channel</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">criterion</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">action</span><span class="p">,</span>
-    <span class="na">path</span><span class="p">:</span> <span class="nx">path</span><span class="p">,</span>
-    <span class="na">headers</span><span class="p">:</span> <span class="nx">dittoHeaders</span><span class="p">,</span>
-    <span class="na">value</span><span class="p">:</span> <span class="nx">value</span><span class="p">,</span>
-    <span class="na">status</span><span class="p">:</span> <span class="nx">status</span><span class="p">,</span>
-    <span class="na">extra</span><span class="p">:</span> <span class="nx">extra</span><span class="p">,</span>
-  <span class="p">};</span>
+    <span class="k">return</span> <span class="p">{</span>
+        <span class="na">topic</span><span class="p">:</span> <span class="nx">topic</span><span class="p">,</span>
+        <span class="na">path</span><span class="p">:</span> <span class="nx">path</span><span class="p">,</span>
+        <span class="na">headers</span><span class="p">:</span> <span class="nx">dittoHeaders</span><span class="p">,</span>
+        <span class="na">value</span><span class="p">:</span> <span class="nx">value</span><span class="p">,</span>
+        <span class="na">status</span><span class="p">:</span> <span class="nx">status</span><span class="p">,</span>
+        <span class="na">extra</span><span class="p">:</span> <span class="nx">extra</span><span class="p">,</span>
+    <span class="p">};</span>
+<span class="p">}</span>
+
+<span class="cm">/**
+ * Builds a Ditto Protocol topic from the passed parameters.
+ * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto". Or "_"
+ * (underscore) for connection announcements.
+ * @param {string} name - The name of the entity, e.g.: "device".
+ * @param {string} channel - The channel for the signal: "twin"|"live"|"none"
+ * @param {string} group - The affected group/entity: "things"|"policies"|"connections".
+ * @param {string} criterion - The criterion to apply: "commands"|"events"|"search"|"messages"|"announcements"|"errors".
+ * @param {string} action - The action to perform: "create"|"retrieve"|"modify"|"delete". Or the announcement name:
+ * "opened"|"closed"|"subjectDeletion". Or the subject of the message.
+ * @returns {string} topic - the topic.
+ */</span>
+<span class="kd">function</span> <span class="nx">buildTopic</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</span><span class="p">,</span> <span class="nx">group</span><span class="p">,</span> <span class="nx">channel</span><span class="p">,</span> <span class="nx">criterion</span><span class="p">,</span> <span class="nx">action</span><span class="p">)</span> <span class="p">{</span>
+    <span class="kd">const</span> <span class="nx">topicChannel</span> <span class="o">=</span> <span class="s1">'none'</span> <span class="o">===</span> <span class="nx">channel</span> <span class="p">?</span> <span class="s1">''</span> <span class="p">:</span> <span class="s1">'/'</span> <span class="o">+</span> <span class="nx">channel</span><span class="p">;</span>
+
+    <span class="k">return</span> <span class="nx">namespace</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">name</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">group</span> <span class="o">+</span> <span class="nx">topicChannel</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">criterion</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">action</span><span class="p">;</span>
 <span class="p">}</span>
 
 <span class="cm">/**
@@ -2295,22 +2366,24 @@
 
 <div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
  * Maps the passed parameters which originated from a Ditto Protocol message to an external message.
- * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
- * @param {string} name - The name of the entity, e.g.: "device"
- * @param {string} channel - The channel for the signal, one of: "twin"|"live"
- * @param {string} group - The affected group/entity, one of: "things"
- * @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
- * @param {string} action - The action to perform, one of: "create"|"retrieve"|"modify"|"delete"
- * @param {string} path - The path which is affected by the message, e.g.: "/attributes"
- * @param {Object.&lt;string, string&gt;} dittoHeaders - The headers Object containing all Ditto Protocol header values
- * @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action)
+ * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto". Or "_" 
+ * (underscore) for connection announcements.
+ * @param {string} name - The name of the entity, e.g.: "device".
+ * @param {string} group - The affected group/entity: "things"|"policies"|"connections".
+ * @param {string} channel - The channel for the signal: "twin"|"live"|"none"
+ * @param {string} criterion - The criterion to apply: "commands"|"events"|"search"|"messages"|"announcements"|
+ * "errors".
+ * @param {string} action - The action to perform: "create"|"retrieve"|"modify"|"delete". Or the announcement name: 
+ * "opened"|"closed"|"subjectDeletion". Or the subject of the message.
+ * @param {string} path - The path which is affected by the message (e.g.: "/attributes"), or the destination
+ * of a message (e.g.: "inbox"|"outbox").
+ * @param {Object.&lt;string, string&gt;} dittoHeaders - The headers Object containing all Ditto Protocol header values.
+ * @param {*} [value] - The value to apply / which was applied (e.g. in a "modify" action).
  * @param {number} [status] - The status code that indicates the result of the command. When this field is set,
  * it indicates that the Ditto Protocol Message contains a response.
  * @param {Object} [extra] - The enriched extra fields when selected via "extraFields" option.
- * @returns {(ExternalMessage|Array&lt;ExternalMessage&gt;)} externalMessage -
- *  The mapped external message,
- *  an array of external messages or
- *  &lt;code&gt;null&lt;/code&gt; if the message could/should not be mapped
+ * @returns {(ExternalMessage|Array&lt;ExternalMessage&gt;)} externalMessage - The mapped external message, an array of 
+ * external messages or &lt;code&gt;null&lt;/code&gt; if the message could/should not be mapped.
  */</span>
 <span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span>
   <span class="nx">namespace</span><span class="p">,</span>
@@ -2701,7 +2774,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-overview.html b/connectivity-overview.html
index 124ecf6..7b00b2b 100644
--- a/connectivity-overview.html
+++ b/connectivity-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1776,7 +1826,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-amqp091.html b/connectivity-protocol-bindings-amqp091.html
index 23b1e59..edf5320 100644
--- a/connectivity-protocol-bindings-amqp091.html
+++ b/connectivity-protocol-bindings-amqp091.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1921,7 +1971,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-amqp10.html b/connectivity-protocol-bindings-amqp10.html
index ee2bbe4..4d4c8de 100644
--- a/connectivity-protocol-bindings-amqp10.html
+++ b/connectivity-protocol-bindings-amqp10.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1898,6 +1948,11 @@
 <a href="https://qpid.apache.org/releases/qpid-jms-0.40.0/docs/index.html#jms-configuration-options">JMS Configuration options</a>. 
 Use these to customize and tweak your connection as needed.</p>
 
+<h3 id="hmac-request-signing">HMAC request signing</h3>
+
+<p>Ditto supports HMAC request signing for AMQP 1.0 connections. Find detailed information on this in
+<a href="connectivity-hmac-signing.html">Connectivity API &gt; HMAC request signing</a>.</p>
+
 <h2 id="establishing-connecting-to-an-amqp-10-endpoint">Establishing connecting to an AMQP 1.0 endpoint</h2>
 
 <p>Ditto’s <a href="architecture-services-connectivity.html">Connectivity service</a> is responsible for creating new and managing 
@@ -1967,7 +2022,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-http.html b/connectivity-protocol-bindings-http.html
index 075a2ec..529b1c6 100644
--- a/connectivity-protocol-bindings-http.html
+++ b/connectivity-protocol-bindings-http.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1729,7 +1779,7 @@
 
     
 
-  <p>Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via <a href="#target-format">targets</a>.</p>
+  <p>Perform HTTP request (with verbs GET, POST, PUT, PATCH) to HTTP endpoints via <a href="#target-format">targets</a>.</p>
 
 <h2 id="specific-connection-configuration">Specific connection configuration</h2>
 
@@ -1747,6 +1797,7 @@
 
 <p>The supported HTTP <code class="highlighter-rouge">&lt;http_verb&gt;</code> values are:</p>
 <ul>
+  <li>GET</li>
   <li>POST</li>
   <li>PUT</li>
   <li>PATCH</li>
@@ -1784,6 +1835,15 @@
 </span><span class="p">}</span><span class="w">
 </span></code></pre></div></div>
 
+<h4 id="target-header-mapping">Target header mapping</h4>
+<p>HTTP 1.1 connections supports specific header mapping.</p>
+
+<p>The following header have a special meaning in that the values are applied directly to the published message:</p>
+<ul>
+  <li><code class="highlighter-rouge">http.query</code>: sets the value of this header as query parameter</li>
+  <li><code class="highlighter-rouge">http.path</code>: sets the value of this header as the path of the HTTP request</li>
+</ul>
+
 <h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
 
 <p>For HTTP targets, whenever a message is published to the HTTP endpoint, you have two different options in order to 
@@ -1941,6 +2001,11 @@
 </span><span class="p">}</span><span class="w">
 </span></code></pre></div></div>
 
+<h3 id="hmac-request-signing">HMAC request signing</h3>
+
+<p>Ditto supports HMAC request signing for HTTP push connections. Find detailed information on this in 
+<a href="connectivity-hmac-signing.html">Connectivity API &gt; HMAC request signing</a>.</p>
+
 
     <div class="tags">
         
@@ -1974,7 +2039,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-kafka2.html b/connectivity-protocol-bindings-kafka2.html
index d5175cf..1ad9c07 100644
--- a/connectivity-protocol-bindings-kafka2.html
+++ b/connectivity-protocol-bindings-kafka2.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1899,7 +1949,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-mqtt.html b/connectivity-protocol-bindings-mqtt.html
index dbadfa5..0b3766d 100644
--- a/connectivity-protocol-bindings-mqtt.html
+++ b/connectivity-protocol-bindings-mqtt.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2171,7 +2221,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-protocol-bindings-mqtt5.html b/connectivity-protocol-bindings-mqtt5.html
index c00c4e9..9aec90f 100644
--- a/connectivity-protocol-bindings-mqtt5.html
+++ b/connectivity-protocol-bindings-mqtt5.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2177,7 +2227,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-ssh-tunneling.html b/connectivity-ssh-tunneling.html
index c0b988f..c4ec01f 100644
--- a/connectivity-ssh-tunneling.html
+++ b/connectivity-ssh-tunneling.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1841,7 +1891,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-tls-certificates.html b/connectivity-tls-certificates.html
index ece007c..906ba1c 100644
--- a/connectivity-tls-certificates.html
+++ b/connectivity-tls-certificates.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1871,7 +1921,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/feed.xml b/feed.xml
index 2b35707..3275105 100644
--- a/feed.xml
+++ b/feed.xml
@@ -5,11 +5,383 @@
         <description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
         <link>https://www.eclipse.org/ditto/</link>
         <atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
-        <pubDate>Thu, 20 May 2021 11:42:21 +0000</pubDate>
-        <lastBuildDate>Thu, 20 May 2021 11:42:21 +0000</lastBuildDate>
+        <pubDate>Mon, 21 Jun 2021 15:42:54 +0000</pubDate>
+        <lastBuildDate>Mon, 21 Jun 2021 15:42:54 +0000</lastBuildDate>
         <generator>Jekyll v3.6.2</generator>
         
         <item>
+            <title>Support for HMAC-SHA256 signing for connections</title>
+            <description>&lt;p&gt;With the upcoming release of Eclipse Ditto &lt;strong&gt;version 2.1.0&lt;/strong&gt; it will be possible to use HMAC-SHA256 signing for
+connections. The currently implemented algorithms support you in authenticating requests against:&lt;/p&gt;
+&lt;ul&gt;
+  &lt;li&gt;Azure IoT Hub REST API&lt;/li&gt;
+  &lt;li&gt;Azure IoT Hub AMQP 1.0&lt;/li&gt;
+  &lt;li&gt;Azure HTTP Monitor Data Collector API&lt;/li&gt;
+  &lt;li&gt;Azure Service Bus REST API&lt;/li&gt;
+  &lt;li&gt;Amazon Simple Notification Service (Amazon SNS)&lt;/li&gt;
+  &lt;li&gt;other AWS services supporting Signature Version 4 signing (see external AWS documentation on 
+&lt;a href=&quot;https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html&quot;&gt;Signing AWS API requests&lt;/a&gt;)&lt;/li&gt;
+&lt;/ul&gt;
+
+&lt;p&gt;Detailed information can be found at &lt;a href=&quot;connectivity-hmac-signing.html&quot;&gt;Connectivity API &amp;gt; HMAC request signing&lt;/a&gt;.&lt;/p&gt;
+
+&lt;p&gt;This blog post shows different configurations with the &lt;code class=&quot;highlighter-rouge&quot;&gt;az-sasl&lt;/code&gt; algorithm, that allow you to sign requests
+against Azure IoT Hub (HTTP Push and AMQP 1.0) as well as Azure Service Bus (HTTP Push).&lt;/p&gt;
+
+&lt;h1 id=&quot;prerequisites&quot;&gt;Prerequisites&lt;/h1&gt;
+
+&lt;p&gt;For the examples you’ll need a running instance of Eclipse Ditto (see &lt;a href=&quot;installation-running.html&quot;&gt;Running Ditto&lt;/a&gt;).
+Additionally, a simple Thing is required, to which messages can be sent to.
+Create the Thing &lt;code class=&quot;highlighter-rouge&quot;&gt;ditto:thing&lt;/code&gt; with a &lt;code class=&quot;highlighter-rouge&quot;&gt;PUT&lt;/code&gt; request to &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;ditto&amp;gt;/api/2/things/ditto:thing&lt;/code&gt; and content&lt;/p&gt;
+
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;thingId&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;ditto:thing&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;attributes&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;features&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;_policy&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;entries&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;DEFAULT&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+        &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;subjects&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;{{ request:subjectId }}&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;the creator&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;integration:ditto&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;the connections&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+        &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+        &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;resources&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;policy:/&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;grant&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;READ&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;WRITE&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;revoke&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;thing:/&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;grant&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;READ&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;WRITE&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;revoke&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;message:/&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;grant&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;READ&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+              &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;WRITE&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+            &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;revoke&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+          &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+        &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;h1 id=&quot;azure-iot-hub-rest-api&quot;&gt;Azure IoT Hub REST API&lt;/h1&gt;
+
+&lt;p&gt;This example shows how to invoke a &lt;a href=&quot;https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-direct-methods&quot;&gt;direct method&lt;/a&gt;
+on a device using Eclipse Ditto and Azure IoT Hub.&lt;/p&gt;
+
+&lt;p&gt;For creating signed requests against the Azure IoT Hub REST API, you’ll need the following information from your
+Azure IoT Hub instance:&lt;/p&gt;
+&lt;ul&gt;
+  &lt;li&gt;The hostname (e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;my-hub.azure-devices.net&lt;/code&gt;).&lt;/li&gt;
+  &lt;li&gt;The name of a (Azure IoT Hub) shared access policy, which has the &lt;code class=&quot;highlighter-rouge&quot;&gt;Service connect&lt;/code&gt; permission. By default, there
+should be a policy named &lt;code class=&quot;highlighter-rouge&quot;&gt;service&lt;/code&gt; which provides this permission.&lt;/li&gt;
+  &lt;li&gt;The primary or secondary key of above policy.&lt;/li&gt;
+  &lt;li&gt;A device in Azure IoT Hub with the ID &lt;code class=&quot;highlighter-rouge&quot;&gt;ditto:thing&lt;/code&gt; (for the example this needs to be the same ID as the Thing created in prerequisites).&lt;/li&gt;
+&lt;/ul&gt;
+
+&lt;p&gt;What follows is a sample connection JSON for a connection named &lt;code class=&quot;highlighter-rouge&quot;&gt;Azure IoT Hub HTTP&lt;/code&gt;, using hostname &lt;code class=&quot;highlighter-rouge&quot;&gt;my-hub.azure-devices.net&lt;/code&gt; and
+shared access policy &lt;code class=&quot;highlighter-rouge&quot;&gt;service&lt;/code&gt; with key &lt;code class=&quot;highlighter-rouge&quot;&gt;theKey&lt;/code&gt;. You can set the correct values from your Azure IoT Hub subscription
+in the fields &lt;code class=&quot;highlighter-rouge&quot;&gt;uri&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKeyName&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKey&lt;/code&gt; and
+&lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.endpoint&lt;/code&gt;.&lt;/p&gt;
+
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;60d193e3-2639-415b-af29-0e337741141d&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;name&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Azure IoT Hub HTTP&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionType&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;http-push&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionStatus&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;open&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;uri&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;https://my-hub.azure-devices.net:443&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sources&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;targets&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;address&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;POST:/twins/{{ thing:id }}/methods?api-version=2018-06-30&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topics&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;_/_/things/live/messages&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;authorizationContext&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;integration:ditto&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;issuedAcknowledgementLabel&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;live-response&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headerMapping&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;payloadMapping&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;javascript&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;clientCount&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;1&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;failoverEnabled&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;validateCertificates&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;processorPoolSize&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;5&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;specificConfig&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;parallelism&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;1&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;mappingDefinitions&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;javascript&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;mappingEngine&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;JavaScript&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;options&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+                    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;incomingScript&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;function mapToDittoProtocolMsg(&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  headers,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  textPayload,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  bytePayload,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  contentType&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;) {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  if (contentType === 'application/vnd.eclipse.ditto+json') {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    return JSON.parse(textPayload);&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  } else if (contentType === 'application/octet-stream') {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    try {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;      return JSON.parse(Ditto.arrayBufferToString(bytePayload));&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    } catch (e) {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;      return null;&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    }&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  }&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  return null;&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+                    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;outgoingScript&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;function mapFromDittoProtocolMsg(&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  namespace,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  name,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  group,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  channel,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  criterion,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  action,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  path,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  dittoHeaders,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  value,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  status,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  extra&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;) {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  let headers = dittoHeaders;&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  let payload = {&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;      &lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;methodName&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;: action,&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;      &lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;responseTimeoutInSeconds&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;: parseInt(dittoHeaders.timeout),&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;      &lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;payload&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\&quot;&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;: value&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  };&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  let textPayload = JSON.stringify(payload);&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  let bytePayload = null;&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  let contentType = 'application/json';&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  return Ditto.buildExternalMsg(&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    headers, // The external headers Object containing header values&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    textPayload, // The external mapped String&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    bytePayload, // The external mapped byte[]&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;    contentType // The returned Content-Type&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;  );&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;se&quot;&gt;\n&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+                    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;loadBytebufferJS&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;false&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+					&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;loadLongJS&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;false&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;credentials&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;hmac&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;algorithm&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;az-sasl&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;parameters&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKeyName&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;service&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;theKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+				&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;endpoint&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;my-hub.azure-devices.net&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+			&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+		&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;tags&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+	&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;This connection configuration sends live messages to the endpoint at
+&lt;code class=&quot;highlighter-rouge&quot;&gt;https://my-hub.azure-devices.net:443/twins/{{ thing:id }}/methods?api-version=2018-06-30&lt;/code&gt;
+and signs each request with a &lt;a href=&quot;https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-dev-guide-sas?tabs=node&quot;&gt;Shared Access Signature&lt;/a&gt;.
+The configuration also contains an outgoing JavaScript payload mapping, which extracts the subject of the live message,
+its timeout and its payload and uses this to construct a JSON message in the required direct method format.
+You’ll see that format below.&lt;/p&gt;
+
+&lt;h2 id=&quot;listen-for-direct-method-on-the-device&quot;&gt;Listen for direct method on the device&lt;/h2&gt;
+
+&lt;p&gt;Your Azure IoT Hub device needs to listen to the direct method you’re calling. Imagine you want to call a
+device method &lt;code class=&quot;highlighter-rouge&quot;&gt;getDeviceLog&lt;/code&gt; on a device. You can use the Nodejs sample &lt;a href=&quot;https://github.com/Azure/azure-iot-sdk-node/blob/f526f203ddc9ee32e3c92066312417d2ef6303de/device/samples/device_methods.js&quot;&gt;device_methods.js from azure-iot-sdk-node/device/samples&lt;/a&gt;
+as a starter. You’ll need to set the &lt;code class=&quot;highlighter-rouge&quot;&gt;DEVICE_CONNECTION_STRING&lt;/code&gt; environment variable to a connection string of the
+device you are using and can run the device with &lt;code class=&quot;highlighter-rouge&quot;&gt;npm install &amp;amp;&amp;amp; node device_methods.js&lt;/code&gt;.&lt;/p&gt;
+
+&lt;h2 id=&quot;send-a-live-message-to-the-thing&quot;&gt;Send a live message to the Thing&lt;/h2&gt;
+
+&lt;p&gt;To invoke the &lt;code class=&quot;highlighter-rouge&quot;&gt;getDeviceLog&lt;/code&gt; method on the device, you should now be able to send a live message to the Thing. The message
+will be forwarded through your connection &lt;code class=&quot;highlighter-rouge&quot;&gt;Azure IoT Hub HTTP&lt;/code&gt; to the Azure IoT Hub, which will route it to the device
+and respond with its response.&lt;/p&gt;
+
+&lt;p&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;POST&lt;/code&gt; a message to &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;ditto&amp;gt;/api/2/things/ditto:thing/inbox/messages/getDeviceLog?timeout=5s&lt;/code&gt; with content:&lt;/p&gt;
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;service&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;my-microservice&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;amount&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;9000&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;The payload mapping of the connection will turn this into a direct method:&lt;/p&gt;
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;methodName&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;getDeviceLog&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;responseTimeoutInSeconds&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;5&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;payload&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;service&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;my-microservice&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;amount&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;9000&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;If you didn’t change the sample code of the device, you should get a response containing &lt;code class=&quot;highlighter-rouge&quot;&gt;example payload&lt;/code&gt;.&lt;/p&gt;
+
+&lt;h1 id=&quot;azure-iot-hub-amqp&quot;&gt;Azure IoT Hub AMQP&lt;/h1&gt;
+
+&lt;p&gt;For using the Azure IoT Hub AMQP endpoint, basically the same prerequisites as for the HTTP endpoint apply.
+The difference is, that it’s not possible to invoke direct methods using the AMQP endpoint. Instead, you can
+send a Cloud To Device (C2D) message, on which the device listens.&lt;/p&gt;
+
+&lt;div class=&quot;alert alert-info&quot; role=&quot;alert&quot;&gt;&lt;i class=&quot;fa fa-info-circle&quot;&gt;&lt;/i&gt; &lt;b&gt;Note:&lt;/b&gt; Instead of signing each request like in HTTP push connections, the connection itself is
+established with signed connection information. For this, the &lt;code class=&quot;highlighter-rouge&quot;&gt;ttl&lt;/code&gt; parameter of the &lt;code class=&quot;highlighter-rouge&quot;&gt;az-sasl&lt;/code&gt; algorithm applies 
+(see &lt;a href=&quot;connectivity-hmac-signing.html#az-sasl&quot;&gt;documentation of the az-sasl algorithm&lt;/a&gt;).&lt;/div&gt;
+
+&lt;p&gt;You can use the Nodejs sample &lt;a href=&quot;https://github.com/Azure/azure-iot-sdk-node/blob/f526f203ddc9ee32e3c92066312417d2ef6303de/device/samples/simple_sample_device.js&quot;&gt;simple_sample_device.js from azure-iot-sdk-node/device/samples&lt;/a&gt;
+to listen on C2D messages as a device. You’ll need to set the &lt;code class=&quot;highlighter-rouge&quot;&gt;DEVICE_CONNECTION_STRING&lt;/code&gt; environment variable to a connection string of the
+device you are using and can run the device with &lt;code class=&quot;highlighter-rouge&quot;&gt;npm install &amp;amp;&amp;amp; node simple_sample_device.js&lt;/code&gt;.&lt;/p&gt;
+
+&lt;p&gt;What follows is a sample connection JSON for a connection named &lt;code class=&quot;highlighter-rouge&quot;&gt;Azure IoT Hub AMPQ&lt;/code&gt;, using hostname &lt;code class=&quot;highlighter-rouge&quot;&gt;my-hub.azure-devices.net&lt;/code&gt; and
+shared access policy &lt;code class=&quot;highlighter-rouge&quot;&gt;service&lt;/code&gt; with key &lt;code class=&quot;highlighter-rouge&quot;&gt;theKey&lt;/code&gt;. You can set the correct values from your Azure IoT Hub subscription
+in the fields &lt;code class=&quot;highlighter-rouge&quot;&gt;uri&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKeyName&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKey&lt;/code&gt; and
+&lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.endpoint&lt;/code&gt;.&lt;/p&gt;
+
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;8caca8c6-10d1-4886-a61f-3ea6270f9d8e&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;name&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Azure IoT Hub AMQP&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionType&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;amqp-10&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionStatus&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;open&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;uri&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;amqps://my-hub.azure-devices.net:5671&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sources&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;targets&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;address&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/messages/devicebound&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topics&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;_/_/things/live/messages&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;authorizationContext&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;integration:ditto&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headerMapping&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;iothub-ack&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;full&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;to&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/devices/{{thing:id}}/messages/devicebound&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;clientCount&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;1&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;failoverEnabled&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;validateCertificates&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;processorPoolSize&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;5&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;credentials&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;hmac&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;algorithm&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;az-sasl&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;parameters&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKeyName&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;service&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;theKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;endpoint&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;my-hub.azure-devices.net&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;tags&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;Instead of applying a payload mapping like in the HTTP example, the connection just sends the ditto protocol live message
+and you should see its content on the device.&lt;/p&gt;
+
+&lt;p&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;POST&lt;/code&gt; a message to &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;ditto&amp;gt;/api/2/things/ditto:thing/inbox/messages/C2DMessage?timeout=0&lt;/code&gt; with content&lt;/p&gt;
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Hello&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;from Ditto&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+&lt;p&gt;and see it arrive at the device.&lt;/p&gt;
+
+&lt;div class=&quot;alert alert-info&quot; role=&quot;alert&quot;&gt;&lt;i class=&quot;fa fa-info-circle&quot;&gt;&lt;/i&gt; &lt;b&gt;Note:&lt;/b&gt; Using the query parameter &lt;code class=&quot;highlighter-rouge&quot;&gt;timeout=0&lt;/code&gt;, you can tell Ditto to not wait for an answer, since
+devices can’t respond to C2D messages.&lt;/div&gt;
+
+&lt;h1 id=&quot;azure-service-bus&quot;&gt;Azure Service Bus&lt;/h1&gt;
+
+&lt;p&gt;This example shows how to send a message to an Azure Service Bus via Eclipse Ditto.&lt;/p&gt;
+
+&lt;p&gt;For creating signed requests against the Azure Service Bus, you’ll need the following information from your
+Azure IoT Hub instance:&lt;/p&gt;
+&lt;ul&gt;
+  &lt;li&gt;A queue (e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;my-queue&lt;/code&gt;).&lt;/li&gt;
+  &lt;li&gt;The hostname (e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;my-bus.servicebus.windows.net&lt;/code&gt;).&lt;/li&gt;
+  &lt;li&gt;The name of a (Azure Service Bus) shared access policy, which has the &lt;code class=&quot;highlighter-rouge&quot;&gt;Send&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;Listen&lt;/code&gt; permissions. By default, there
+should be a policy named &lt;code class=&quot;highlighter-rouge&quot;&gt;RootManageSharedAccessKey&lt;/code&gt; which provides this permission (but shouldn’t be used in production
+scenarios).&lt;/li&gt;
+  &lt;li&gt;The &lt;code class=&quot;highlighter-rouge&quot;&gt;Base64&lt;/code&gt; encoded primary or secondary key of above policy. The signing will only work if you encode the key with
+&lt;code class=&quot;highlighter-rouge&quot;&gt;Base64&lt;/code&gt; (although it already has &lt;code class=&quot;highlighter-rouge&quot;&gt;Base64&lt;/code&gt; encoding). E.g. if the primary key is &lt;code class=&quot;highlighter-rouge&quot;&gt;theKey&lt;/code&gt;, you need to use its encoded
+version &lt;code class=&quot;highlighter-rouge&quot;&gt;dGhlS2V5&lt;/code&gt;.&lt;/li&gt;
+&lt;/ul&gt;
+
+&lt;p&gt;What follows is a sample connection JSON for a connection named &lt;code class=&quot;highlighter-rouge&quot;&gt;Azure Service Bus HTTP&lt;/code&gt;, using hostname &lt;code class=&quot;highlighter-rouge&quot;&gt;my-bus.servicebus.windows.net&lt;/code&gt; and
+shared access policy &lt;code class=&quot;highlighter-rouge&quot;&gt;RootManageSharedAccessKey&lt;/code&gt; with encoded key &lt;code class=&quot;highlighter-rouge&quot;&gt;dGhlS2V5&lt;/code&gt; (&lt;code class=&quot;highlighter-rouge&quot;&gt;theKey&lt;/code&gt;). You can set the correct values
+from your Azure Service Bus subscription in the fields &lt;code class=&quot;highlighter-rouge&quot;&gt;uri&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKeyName&lt;/code&gt;,
+&lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.sharedKey&lt;/code&gt; and
+&lt;code class=&quot;highlighter-rouge&quot;&gt;credentials.parameters.endpoint&lt;/code&gt; (which is a combination of the hostname and queue name).&lt;/p&gt;
+
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;adec2846-4d11-4e0a-b456-d8bfc2192fc6&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;name&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Azure Service Bus HTTP&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionType&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;http-push&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;connectionStatus&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;open&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;uri&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;https://my-bus.servicebus.windows.net:443&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sources&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;targets&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;address&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;POST:/my-queue/messages&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topics&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;_/_/things/live/messages&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;authorizationContext&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;integration:ditto&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;issuedAcknowledgementLabel&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;live-response&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headerMapping&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;clientCount&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;1&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;failoverEnabled&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;validateCertificates&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;processorPoolSize&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;5&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;specificConfig&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;parallelism&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;1&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;credentials&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;hmac&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;algorithm&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;az-sasl&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;parameters&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKeyName&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;RootManageSharedAccessKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;sharedKey&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;dGhlS2V5&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;endpoint&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;https://my-bus.servicebus.windows.net/my-queue&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;tags&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;This connection configuration sends live messages to the endpoint at &lt;code class=&quot;highlighter-rouge&quot;&gt;https://my-hub.servicebus.windows.net.net:443/my-queue/messages&lt;/code&gt;
+and signs each request with a &lt;a href=&quot;https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas#overview-of-sas&quot;&gt;Shared Access Signature&lt;/a&gt;.&lt;/p&gt;
+
+&lt;h2 id=&quot;listen-for-the-message&quot;&gt;Listen for the message&lt;/h2&gt;
+
+&lt;p&gt;To listen for the message you send into the Service Bus, you can use the Nodejs sample 
+&lt;a href=&quot;https://github.com/Azure/azure-sdk-for-js/blob/d7d67ccc865318f3dc6395e0db6997b5af8cf5e8/sdk/servicebus/service-bus/samples/v7/javascript/receiveMessagesStreaming.js&quot;&gt;receiveMessagesStreaming.js from azure-sdk-for-js/sdk/servicebus/service-bus/samples/v7/javascript&lt;/a&gt;.
+You’ll need to set the &lt;code class=&quot;highlighter-rouge&quot;&gt;SERVICEBUS_CONNECTION_STRING&lt;/code&gt; environment variable to the connection string of the used
+shared access policy. Also, you’ll need to set the &lt;code class=&quot;highlighter-rouge&quot;&gt;QUEUE_NAME&lt;/code&gt; environment variable to the
+used queue (e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;my-queue&lt;/code&gt;). You should be able to run the sample using &lt;code class=&quot;highlighter-rouge&quot;&gt;npm install &amp;amp;&amp;amp; node receiveMessagesStreaming.js&lt;/code&gt;.&lt;/p&gt;
+
+&lt;h2 id=&quot;send-a-live-message-to-the-thing-1&quot;&gt;Send a live message to the Thing&lt;/h2&gt;
+
+&lt;p&gt;To send a message to Service Bus, you can simply send a live message to a Thing. The message
+will be forwarded through your connection &lt;code class=&quot;highlighter-rouge&quot;&gt;Azure Service Bus HTTP&lt;/code&gt; to the Azure Service Bus, from which the sample
+app can read the message.&lt;/p&gt;
+
+&lt;p&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;POST&lt;/code&gt; a message to &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;ditto&amp;gt;/api/2/things/ditto:thing/inbox/messages/HelloServiceBus&lt;/code&gt; with content:&lt;/p&gt;
+&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Hello&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;from Ditto&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
+&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
+
+&lt;p&gt;If you didn’t change the sample code you should see the message arriving there.&lt;/p&gt;
+
+&lt;h2 id=&quot;feedback&quot;&gt;Feedback?&lt;/h2&gt;
+
+&lt;p&gt;Find details on the different algorithms and their parameters at
+&lt;a href=&quot;connectivity-hmac-signing.html&quot;&gt;Connectivity API &amp;gt; HMAC request signing&lt;/a&gt;.&lt;/p&gt;
+
+&lt;p&gt;Please &lt;a href=&quot;feedback.html&quot;&gt;get in touch&lt;/a&gt; if you have feedback or questions regarding this new functionality.&lt;/p&gt;
+
+&lt;p&gt;&lt;br /&gt;
+&lt;br /&gt;&lt;/p&gt;
+&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
+
+&lt;p&gt;–&lt;br /&gt; 
+The Eclipse Ditto team&lt;/p&gt;
+</description>
+            <pubDate>Thu, 17 Jun 2021 00:00:00 +0000</pubDate>
+            <link>https://www.eclipse.org/ditto/2021-06-17-hmac-credentials.html</link>
+            <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-06-17-hmac-credentials.html</guid>
+            
+            <category>blog</category>
+            
+            <category>architecture</category>
+            
+            <category>connectivity</category>
+            
+            <category>hmac</category>
+            
+            <category>azure</category>
+            
+            <category>azure iot hub</category>
+            
+            <category>azure service bus</category>
+            
+            <category>azure monitor</category>
+            
+            <category>aws sns</category>
+            
+            <category>sns</category>
+            
+            <category>aws</category>
+            
+            <category>signing</category>
+            
+            <category>example</category>
+            
+            
+        </item>
+        
+        <item>
             <title>Announcing Eclipse Ditto Release 2.0.0</title>
             <description>&lt;p&gt;Today, ~1.5 years after release &lt;a href=&quot;2019-12-12-release-announcement-100.html&quot;&gt;1.0.0&lt;/a&gt;, the Eclipse Ditto team is happy to 
 announce the availability of Eclipse Ditto &lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/2.0.0&quot;&gt;2.0.0&lt;/a&gt;.&lt;/p&gt;
@@ -1298,312 +1670,5 @@
             
         </item>
         
-        <item>
-            <title>E2E acknowledgment</title>
-            <description>&lt;h2 id=&quot;e2e-acknowledgement-using-eclipse-ditto&quot;&gt;E2E acknowledgement using Eclipse Ditto&lt;/h2&gt;
-
-&lt;p&gt;By adding the new &lt;a href=&quot;basic-acknowledgements.html&quot;&gt;acknowledgements feature&lt;/a&gt; to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1.
-Previously the &lt;a href=&quot;architecture-services-connectivity.html&quot;&gt;connectivity service&lt;/a&gt; of Ditto did accept all incoming messages immediately as soon as it received the message.&lt;/p&gt;
-
-&lt;p&gt;This behaviour can now be controlled by a Ditto header called &lt;a href=&quot;basic-acknowledgements.html#requesting-acks&quot;&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks&lt;/code&gt;&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;In this blog post I will provide a few examples for how to use this new feature in the following scenarios:&lt;/p&gt;
-
-&lt;ol&gt;
-  &lt;li&gt;Device publishes a change of its state and doesn’t care about whether the event regarding this change will be received by any subscriber or not.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-1---fire-and-forget&quot;&gt;fire and forget&lt;/a&gt; scenario.&lt;/li&gt;
-  &lt;li&gt;Device publishes a change of its state and wants to be sure it is persisted in Ditto.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-2---processed-in-ditto&quot;&gt;processed in Ditto&lt;/a&gt; scenario.&lt;/li&gt;
-  &lt;li&gt;Device publishes a change of its state and wants to be sure an application connected to Eclipse Ditto will receive the event regarding this change of the state.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-3---notification-scenario&quot;&gt;notification&lt;/a&gt; scenario.&lt;/li&gt;
-  &lt;li&gt;Device publishes a change of its state and wants to be notified when a subscriber was not able to receive the event regarding this change.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-4---tracked-notification-scenario&quot;&gt;tracked notification&lt;/a&gt; scenario.&lt;/li&gt;
-  &lt;li&gt;Device sends a live message and wants to be sure that it will eventually receive a response.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-5---long-running-live-message-scenario&quot;&gt;long running live message&lt;/a&gt; scenario.&lt;/li&gt;
-  &lt;li&gt;Device sends a live message and wants to either receive the response within a given timeout or never.&lt;br /&gt;
-This is the &lt;a href=&quot;#scenario-6---asking-for-required-information-scenario&quot;&gt;asking for required information&lt;/a&gt; scenario.&lt;/li&gt;
-&lt;/ol&gt;
-
-&lt;h2 id=&quot;scenarios&quot;&gt;Scenarios&lt;/h2&gt;
-
-&lt;p&gt;The following scenarios all share the same context:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;a device sends data/messages via a device connectivity layer (e.g. &lt;a href=&quot;https://eclipse.org/hono/&quot;&gt;Eclipse Hono&lt;/a&gt; or an MQTT broker) to Ditto&lt;/li&gt;
-  &lt;li&gt;Ditto’s &lt;a href=&quot;architecture-services-connectivity.html&quot;&gt;connectivity service&lt;/a&gt;
-    &lt;ul&gt;
-      &lt;li&gt;consumes the &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message&lt;/li&gt;
-      &lt;li&gt;forwards the message into the Ditto cluster to be processed&lt;/li&gt;
-      &lt;li&gt;is responsible for technically acknowledging/settling the consumed message at the device connectivity layer / broker
-        &lt;ul&gt;
-          &lt;li&gt;the strategy of when this is done and with which outcome is handled by the Ditto headers mentioned in the scenarios&lt;/li&gt;
-        &lt;/ul&gt;
-      &lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Although all scenarios are based on the device sending something (e.g. telemetry data or a message), the 
-E2E acknowledgement can also be used the other way around when e.g. a backend application sends something to a device.&lt;/p&gt;
-
-&lt;h3 id=&quot;scenario-1---fire-and-forget&quot;&gt;Scenario 1 - Fire and Forget&lt;/h3&gt;
-
-&lt;p&gt;This is the simplest scenario of all, since the change can be published in a fire and forget semantics.&lt;/p&gt;
-
-&lt;p&gt;In this scenario the device will send the modification command containing the headers:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;response-required=false&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks=[]&lt;/code&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/twin/commands/modify&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;false&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/features/lightSwitch/properties/status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;on&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;For this case the connectivity service will immediately acknowledge the incoming message at the messaging system and then continues to process the command.&lt;/p&gt;
-
-&lt;p&gt;It doesn’t matter if the command could be processed successfully or if any subscriber received an event for this change.&lt;/p&gt;
-
-&lt;h3 id=&quot;scenario-2---processed-in-ditto&quot;&gt;Scenario 2 - Processed in Ditto&lt;/h3&gt;
-
-&lt;p&gt;For this scenario the device wants to be sure its change will be properly persisted in Ditto.&lt;/p&gt;
-
-&lt;p&gt;The command needs to define the following headers:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;response-required=false&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks=[&quot;twin-persisted&quot;]&lt;/code&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/twin/commands/modify&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;false&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;twin-persisted&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/features/lightSwitch/properties/status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;on&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;For this case the connectivity service will wait until the modification will be properly persisted in Ditto before acknowledging the incoming message at the messaging system.&lt;/p&gt;
-
-&lt;p&gt;If the device published this command for example via an AMQP broker (with a QoS 1 “at least once” semantic), 
-this will cause the broker to redeliver the command to Ditto if the acknowledgment fails.&lt;br /&gt;
-Please be aware that a redelivery will only be requested for the following error status codes:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;408&lt;/code&gt; (Request timed out)&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;424&lt;/code&gt; (Dependency Failure)&lt;/li&gt;
-  &lt;li&gt;All kinds of &lt;code class=&quot;highlighter-rouge&quot;&gt;5xx&lt;/code&gt; status codes&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;In this scenario it does matter if the command could be processed successfully, but it’s still not relevant if any subscriber received an event for this change.&lt;/p&gt;
-
-&lt;h3 id=&quot;scenario-3---notification-scenario&quot;&gt;Scenario 3 - Notification scenario&lt;/h3&gt;
-
-&lt;p&gt;For this scenario the device wants to be sure another system will be notified about the change of its state.&lt;/p&gt;
-
-&lt;p&gt;This could be for example an alarming system which wants to be sure a backend application receives the information that the alarm was triggered.&lt;/p&gt;
-
-&lt;p&gt;A prerequisite for this is that any kind of connection exists that publishes the event to the backend application and declares a user defined acknowledgement label.
-This can be a &lt;a href=&quot;httpapi-protocol-bindings-websocket.html&quot;&gt;WebSocket session&lt;/a&gt; or any kind of Ditto Connection types which can be found &lt;a href=&quot;connectivity-overview.html&quot;&gt;here&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;For this example we expect the event to be forwarded by an &lt;a href=&quot;connectivity-protocol-bindings-http.html&quot;&gt;HTTP connection&lt;/a&gt; 
-which declared the following acknowledgement label as 
-&lt;a href=&quot;basic-connections.html#target-issued-acknowledgement-label&quot;&gt;issued acknowledgement of the target&lt;/a&gt;: &lt;code class=&quot;highlighter-rouge&quot;&gt;d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&lt;/code&gt;.&lt;/p&gt;
-
-&lt;p&gt;The UUID prefix in this case is the ID of the HTTP connection and the&lt;code class=&quot;highlighter-rouge&quot;&gt;backend-process&lt;/code&gt; part is a custom label, defined by the user.&lt;/p&gt;
-
-&lt;p&gt;The command needs to define the following headers:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;response-required=false&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks=[&quot;d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&quot;]&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;timeout=30s&lt;/code&gt; (optional. Default is 10s.)&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/twin/commands/modify&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;false&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;timeout&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;30s&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/features/alarm/properties/status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;on&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;For this case the connectivity service will wait until the HTTP request, which forwards the event regarding the thing change, 
-will be finished before acknowledging the incoming message at the messaging system.&lt;/p&gt;
-
-&lt;p&gt;The status code of the HTTP response will in this case determine if the message will be acknowledged successfully or not and if a redelivery will be requested or not.&lt;br /&gt;
-All kinds of &lt;code class=&quot;highlighter-rouge&quot;&gt;2xx&lt;/code&gt; status codes will lead to a successful acknowledgement at the messaging system.&lt;br /&gt;
-All other status codes will lead to a failed acknowledgement at the messaging system and for the following status codes a redelivery will be requested:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;408&lt;/code&gt; (Request timed out)&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;424&lt;/code&gt; (Dependency Failure)&lt;/li&gt;
-  &lt;li&gt;All kinds of &lt;code class=&quot;highlighter-rouge&quot;&gt;5xx&lt;/code&gt; status codes&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;In this scenario it is ensured a specified subscriber will receive an event for this change.&lt;/p&gt;
-
-&lt;h3 id=&quot;scenario-4---tracked-notification-scenario&quot;&gt;Scenario 4 - Tracked notification scenario&lt;/h3&gt;
-
-&lt;p&gt;For this scenario the device wants to know when a system could not be notified about the change of its state.&lt;/p&gt;
-
-&lt;p&gt;This could be for example an alarming system which wants to be sure a backend application receives the information, 
-or if not: tries to send an SMS as notification.&lt;/p&gt;
-
-&lt;p&gt;This scenario is mostly like scenario 3, but needs to set the &lt;code class=&quot;highlighter-rouge&quot;&gt;response-required&lt;/code&gt; header to &lt;code class=&quot;highlighter-rouge&quot;&gt;true&lt;/code&gt; and it’s required 
-to &lt;a href=&quot;basic-connections.html#source-reply-target&quot;&gt;configure the reply-target of the source&lt;/a&gt; to also expect “nack” responses.&lt;/p&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/twin/commands/modify&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/features/alarm/properties/status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;on&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;In this case the device will receive an acknowledgement response containing the status code and payload of the response of the backend application.&lt;br /&gt;
-Based on this the device can decide how to handle the situation.&lt;br /&gt;
-It is suggested to publish the modification command with QoS 0 (“at most once” semantics) in this case because the 
-device handles the result of the E2E acknowledgement. With QoS 1 (“at least once” semantics) brokers would usually redeliver the message to Ditto.&lt;/p&gt;
-
-&lt;p&gt;If the HTTP endpoint of the backend application responds with the following response:&lt;/p&gt;
-
-&lt;p&gt;headers:&lt;/p&gt;
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&quot;content-type&quot;: &quot;application/json&quot;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;body:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;errorCode&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;notification.smartphone.failed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;message&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Could not notify smartphone.&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;status code: &lt;code class=&quot;highlighter-rouge&quot;&gt;424&lt;/code&gt;&lt;/p&gt;
-
-&lt;p&gt;The response received at the device would look like this:&lt;/p&gt;
-
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/twin/acks/d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;false&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;timeout&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;30s&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;content-type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;application/json&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;errorCode&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;notification.smartphone.failed&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;message&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;Could not notify smartphone.&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;424&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;scenario-5---long-running-live-message-scenario&quot;&gt;Scenario 5 - Long running live message scenario&lt;/h3&gt;
-
-&lt;p&gt;For this scenario the device is going to ask for an information which it needs eventually.&lt;/p&gt;
-
-&lt;p&gt;Let’s say the device asks for the endpoint where it should download the new firmware from.&lt;br /&gt;
-It’s not required that this response arrives within a given time. It’s just required to eventually arrive at the device 
-and after it was received the device can signal the user, that it is ready to download the firmware.&lt;/p&gt;
-
-&lt;p&gt;The headers of the live message should have the following values:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;response-required=true&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks=[&quot;live-response&quot;]&lt;/code&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/live/messages/firmware&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;live-response&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;content-type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;text/plain&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;timeout&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;5s&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/outbox/messages/firmware&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;firmware.url.query&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;By requesting the acknowledgement &lt;code class=&quot;highlighter-rouge&quot;&gt;live-response&lt;/code&gt; the connectivity service will wait until the response for the live message arrived 
-for 5s before acknowledging the incoming message at the broker and will request a redelivery if the response did not arrive within this timeout.&lt;/p&gt;
-
-&lt;p&gt;This will repeat until either the broker discards the message or the response arrives in the specified timeout.
-That way it is guaranteed that the device will eventually receive the response.&lt;/p&gt;
-
-&lt;h3 id=&quot;scenario-6---asking-for-required-information-scenario&quot;&gt;Scenario 6 - Asking for required information scenario&lt;/h3&gt;
-
-&lt;p&gt;For this scenario the device is going to ask for an information which it needs right now to proceed with its current task.&lt;/p&gt;
-
-&lt;p&gt;Let’s say the device asks if it should allow a car with a license plate it detected to drive on the property by opening the barrier.
-It could be possible to ask for that information, so the barrier opens automatically, but providing a fallback mechanism 
-like entering a code directly at the device if this response does not arrive within time.&lt;/p&gt;
-
-&lt;p&gt;The headers of the live message should have the following values:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;response-required=true&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;requested-acks=[]&lt;/code&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Example &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/my-thing/things/live/messages/car-enter&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;headers&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;response-required&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;kc&quot;&gt;true&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;requested-acks&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[],&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;content-type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;text/plain&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;timeout&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;5s&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/outbox/messages/car-enter&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;FN IB 1337&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;By requesting explicitly not requesting any acknowledgement but still requiring a response, the connectivity service will 
-immediately acknowledge the incoming message at the broker. The device will then either receive the response within the specified timeout or never.
-So the device can provide its alternative options to open the barrier after 5 seconds.&lt;/p&gt;
-
-&lt;h2 id=&quot;we-embrace-your-feedback&quot;&gt;We embrace your feedback&lt;/h2&gt;
-
-&lt;p&gt;I hope I could demonstrate the power of the new acknowledgement feature properly and could make it clear how it can be used.
-Maybe you did recognize some of your use cases in the given examples or maybe you have another use case which can or cannot be solved by this feature.&lt;/p&gt;
-
-&lt;p&gt;We would love to get your &lt;a href=&quot;feedback.html&quot;&gt;feedback&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Fri, 23 Oct 2020 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2020-10-23-end-2-end-acknowledgment.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-10-23-end-2-end-acknowledgment.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
     </channel>
 </rss>
diff --git a/feedback.html b/feedback.html
index f6c37a9..3e992df 100644
--- a/feedback.html
+++ b/feedback.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1767,7 +1817,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/glossary.html b/glossary.html
index 1905744..68c2174 100644
--- a/glossary.html
+++ b/glossary.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1763,7 +1813,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/http-api-doc.html b/http-api-doc.html
index ffb2079..12c5010 100644
--- a/http-api-doc.html
+++ b/http-api-doc.html
@@ -219,7 +219,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-concepts.html b/httpapi-concepts.html
index ed3a681..28b41bb 100644
--- a/httpapi-concepts.html
+++ b/httpapi-concepts.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2397,7 +2447,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-messages.html b/httpapi-messages.html
index ee103ed..c37e2b8 100644
--- a/httpapi-messages.html
+++ b/httpapi-messages.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1851,7 +1901,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-overview.html b/httpapi-overview.html
index f4eeefb..719ae5a 100644
--- a/httpapi-overview.html
+++ b/httpapi-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1772,7 +1822,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-protocol-bindings-cloudevents.html b/httpapi-protocol-bindings-cloudevents.html
index fef9667..0775840 100644
--- a/httpapi-protocol-bindings-cloudevents.html
+++ b/httpapi-protocol-bindings-cloudevents.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1857,7 +1907,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-protocol-bindings-websocket.html b/httpapi-protocol-bindings-websocket.html
index 4f4959c..94174b1 100644
--- a/httpapi-protocol-bindings-websocket.html
+++ b/httpapi-protocol-bindings-websocket.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2101,7 +2151,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-search.html b/httpapi-search.html
index 04bad7f..0704615 100644
--- a/httpapi-search.html
+++ b/httpapi-search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1819,7 +1869,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-sse.html b/httpapi-sse.html
index 9c99e8d..1f9490a 100644
--- a/httpapi-sse.html
+++ b/httpapi-sse.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2005,7 +2055,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/index.html b/index.html
index 8fa64af..f45c3e3 100644
--- a/index.html
+++ b/index.html
@@ -281,7 +281,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-building.html b/installation-building.html
index d8e89fd..a2356aa 100644
--- a/installation-building.html
+++ b/installation-building.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1790,7 +1840,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-operating.html b/installation-operating.html
index 0256f95..58ffb3b 100644
--- a/installation-operating.html
+++ b/installation-operating.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1907,6 +1957,8 @@
       </li>
       <li>the format in which logging is done is “LogstashEncoder” format - that way the logfiles may easily be imported into
 an ELK stack</li>
+      <li>when running Ditto in Kubernetes apply the <code class="highlighter-rouge">ditto-log-files.yaml</code> to your Kubernetes cluster in order to 
+mount log files to the host system.</li>
     </ul>
   </li>
 </ul>
@@ -2118,7 +2170,7 @@
 
 <p><code class="highlighter-rouge">GET /devops/config?path=ditto.info</code></p>
 
-<p>It is recommended to not omit the query parameter <code class="highlighter-rouge">path</code>. Otherwise the full configurations of all services are
+<p>It is recommended to not omit the query parameter <code class="highlighter-rouge">path</code>. Otherwise, the full configurations of all services are
 aggregated in the response, which can become megabytes big.</p>
 
 <p>The path <code class="highlighter-rouge">ditto.info</code> points to information on service name, service instance index, JVM arguments and environment
@@ -2703,7 +2755,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/installation-running.html b/installation-running.html
index 9a99192..dbd85be 100644
--- a/installation-running.html
+++ b/installation-running.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-digitaltwins.html b/intro-digitaltwins.html
index fd0a1bb..a1d9ce6 100644
--- a/intro-digitaltwins.html
+++ b/intro-digitaltwins.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1793,7 +1843,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-hello-world.html b/intro-hello-world.html
index 7fb1f59..db56153 100644
--- a/intro-hello-world.html
+++ b/intro-hello-world.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1884,7 +1934,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/intro-overview.html b/intro-overview.html
index db91a6d..5ca593c 100644
--- a/intro-overview.html
+++ b/intro-overview.html
@@ -906,6 +906,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1058,7 +1065,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1093,6 +1100,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1635,6 +1664,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1811,7 +1861,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/jsonschema/connection.json b/jsonschema/connection.json
index ab31c60..bf7337d 100644
--- a/jsonschema/connection.json
+++ b/jsonschema/connection.json
@@ -24,7 +24,14 @@
     "connectionType": {
       "$id": "/properties/connectionType",
       "type": "string",
-      "enum": [ "amqp-091", "amqp-10", "mqtt", "mqtt-5", "kafka", "http-push" ],
+      "enum": [
+        "amqp-091",
+        "amqp-10",
+        "mqtt",
+        "mqtt-5",
+        "kafka",
+        "http-push"
+      ],
       "title": "Connection type",
       "description": "The type determining the connection's underlying transport protocol",
       "examples": [
@@ -34,7 +41,10 @@
     "connectionStatus": {
       "$id": "/properties/connectionStatus",
       "type": "string",
-      "enum": [ "open", "closed" ],
+      "enum": [
+        "open",
+        "closed"
+      ],
       "title": "Connection status",
       "description": "The persisted/desired status of the connection",
       "examples": [
@@ -61,40 +71,237 @@
       ]
     },
     "credentials": {
-      "$id": "/properties/credentials",
-      "type": "object",
-      "title": "Credentials",
-      "description": "Credentials with which Ditto authenticates itself at the connection URI",
-      "properties": {
-        "type": {
-          "$id": "/properties/credentials/properties/type",
-          "type": "string",
-          "enum": [ "client-cert" ],
-          "title": "Type of credentials",
-          "description": "Type of credentials",
-          "examples": [
-            "client-cert"
-          ]
+      "oneOf": [
+        {
+          "$id": "/properties/credentials#ClientCertificate",
+          "type": "object",
+          "title": "Client certificate",
+          "description": "Client certificate with which Ditto authenticates itself at the connection URI",
+          "properties": {
+            "type": {
+              "$id": "/properties/credentials/properties/type",
+              "type": "string",
+              "enum": [
+                "client-cert"
+              ],
+              "title": "Type of credentials",
+              "description": "Type of credentials",
+              "examples": [
+                "client-cert"
+              ]
+            },
+            "cert": {
+              "$id": "/properties/credentials/properties/cert",
+              "type": "string",
+              "title": "Client certificate for type client-cert",
+              "description": "Client certificate for type client-cert as DER in PEM-format",
+              "examples": [
+                "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
+              ]
+            },
+            "key": {
+              "$id": "/properties/credentials/properties/key",
+              "type": "string",
+              "title": "Client private key for type client-cert",
+              "description": "Unencrypted client private for type client-cert as PKCS8 in PEM-format",
+              "examples": [
+                "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+              ]
+            }
+          }
         },
-        "cert": {
-          "$id": "/properties/credentials/properties/cert",
-          "type": "string",
-          "title": "Client certificate for type client-cert",
-          "description": "Client certificate for type client-cert as DER in PEM-format",
-          "examples": [
-            "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
-          ]
+        {
+          "$id": "/properties/credentials#aws4-hmac-sha256",
+          "type": "object",
+          "title": "AWS",
+          "description": "HMAC credentials with which Ditto authenticates itself at an AWS endpoint over HTTP",
+          "properties": {
+            "type": {
+              "$id": "/properties/credentials/properties/type#aws4-hmac-sha256",
+              "type": "string",
+              "enum": [
+                "hmac"
+              ],
+              "title": "Type of credentials",
+              "description": "Type of credentials",
+              "examples": [
+                "hmac"
+              ]
+            },
+            "algorithm": {
+              "$id": "/properties/credentials/properties/algorithm#aws4-hmac-sha256",
+              "type": "string",
+              "title": "Algorithm",
+              "description": "Name of the HMAC signing algorithm",
+              "enum": ["aws4-hmac-sha256"],
+              "examples": ["aws4-hmac-sha256"]
+            },
+            "parameters": {
+              "$id": "/properties/credentials/properties/parameters#aws4-hmac-sha256",
+              "type": "object",
+              "title": "Parameters",
+              "description": "Parameters of the signing algorithm `aws4-hmac-sha256`",
+              "properties": {
+                "region": {
+                  "$id": "/properties/credentials/properties/parameters/region#aws4-hmac-sha256",
+                  "type": "string",
+                  "title": "Region",
+                  "description": "Region of the AWS endpoint"
+                },
+                "service": {
+                  "$id": "/properties/credentials/properties/parameters/service#aws4-hmac-sha256",
+                  "type": "string",
+                  "title": "Service",
+                  "description": "Service name of the AWS endpoint"
+                },
+                "accessKey": {
+                  "$id": "/properties/credentials/properties/parameters/accessKey#aws4-hmac-sha256",
+                  "type": "string",
+                  "title": "Access key",
+                  "description": "Access key of the signing user"
+                },
+                "secretKey": {
+                  "$id": "/properties/credentials/properties/parameters/secretKey#aws4-hmac-sha256",
+                  "type": "string",
+                  "title": "Secret key",
+                  "description": "Secret key of the signing user"
+                },
+                "doubleEncode": {
+                  "$id": "/properties/credentials/properties/parameters/doubleEncode#aws4-hmac-sha256",
+                  "type": "boolean",
+                  "title": "Double encode",
+                  "description": "Whether to double-encode and normalize path segments during request signing. Should be `false` for S3 and `true` for other services.",
+                  "default": true
+                },
+                "canonicalHeaders": {
+                  "$id": "/properties/credentials/properties/parameters/canonicalHeaders#aws4-hmac-sha256",
+                  "type": "array",
+                  "title": "Canonical headers",
+                  "description": "Array of names of headers to include in the signature. Default to `[\"host\"]`",
+                  "default": ["host"]
+                },
+                "xAmzContentSha256": {
+                  "$id": "/properties/credentials/properties/parameters/xAmzContentSha256#aws4-hmac-sha256",
+                  "type": "string",
+                  "enum": ["EXCLUDED", "INCLUDED", "UNSIGNED"],
+                  "title": "X-AMZ-CONTENT-SHA256",
+                  "description": "Configuration for the header `x-amz-content-sha256`, which is mandatory for S3. `EXCLUDED`: do not send the header for non-S3 services. `INCLUDED`: sign the payload hash as the value of the header for S3. `UNSIGNED`: omit the payload hash in the signature for S3.",
+                  "default": "EXCLUDED"
+                }
+              }
+            }
+          }
         },
-        "key": {
-          "$id": "/properties/credentials/properties/key",
-          "type": "string",
-          "title": "Client private key for type client-cert",
-          "description": "Unencrypted client private for type client-cert as PKCS8 in PEM-format",
-          "examples": [
-            "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
-          ]
+        {
+          "$id": "/properties/credentials#az-monitor",
+          "type": "object",
+          "title": "Azure Monitor",
+          "description": "HMAC credentials with which Ditto authenticates itself at Azure Monitor Data Collector over HTTP",
+          "properties": {
+            "type": {
+              "$id": "/properties/credentials/properties/type#az-monitor",
+              "type": "string",
+              "enum": [
+                "hmac"
+              ],
+              "title": "Type of credentials",
+              "description": "Type of credentials",
+              "examples": [
+                "hmac"
+              ]
+            },
+            "algorithm": {
+              "$id": "/properties/credentials/properties/algorithm#az-monitor",
+              "type": "string",
+              "title": "Algorithm",
+              "description": "Name of the HMAC signing algorithm",
+              "enum": ["az-monitor-2016-04-01"],
+              "examples": ["az-monitor-2016-04-01"]
+            },
+            "parameters": {
+              "$id": "/properties/credentials/properties/parameters#az-monitor",
+              "type": "object",
+              "title": "Parameters",
+              "description": "Parameters of the signing algorithm `az-monitor-2016-04-01`",
+              "properties": {
+                "workspaceId": {
+                  "$id": "/properties/credentials/properties/parameters/workspaceId#az-monitor",
+                  "type": "string",
+                  "title": "Workspace ID",
+                  "description": "ID of the Azure Monitor workspace"
+                },
+                "sharedKey": {
+                  "$id": "/properties/credentials/properties/parameters/sharedKey#az-monitor",
+                  "type": "string",
+                  "title": "Shared key",
+                  "description": "Primary or secondary key of the Azure Monitor workspace"
+                }
+              }
+            }
+          }
+        },
+        {
+          "$id": "/properties/credentials#az-sasl",
+          "type": "object",
+          "title": "Azure SASL",
+          "description": "HMAC credentials with which Ditto authenticates itself at Azure IoT Hub over HTTP/AMQP and Azure Service Bus over HTTP",
+          "properties": {
+            "type": {
+              "$id": "/properties/credentials/properties/type#az-sasl",
+              "type": "string",
+              "enum": [
+                "hmac"
+              ],
+              "title": "Type of credentials",
+              "description": "Type of credentials",
+              "examples": [
+                "hmac"
+              ]
+            },
+            "algorithm": {
+              "$id": "/properties/credentials/properties/algorithm#az-sasl",
+              "type": "string",
+              "title": "Algorithm",
+              "description": "Name of the HMAC signing algorithm",
+              "enum": ["az-sasl"],
+              "examples": ["az-sasl"]
+            },
+            "parameters": {
+              "$id": "/properties/credentials/properties/parameters#az-sasl",
+              "type": "object",
+              "title": "Parameters",
+              "description": "Parameters of the signing algorithm `az-sasl`",
+              "properties": {
+                "sharedKey": {
+                  "$id": "/properties/credentials/properties/parameters/sharedKey#az-sasl",
+                  "type": "string",
+                  "title": "Shared key",
+                  "description": "Primary or secondary key of the Azure IoT Hub or Azure Service Bus instance. The key for Azure Service Bus needs an additional Base64 encoding to work (e.g. a primary key 'theKey' should be encoded to 'dGhlS2V5' and used in this format)"
+                },
+                "sharedKeyName": {
+                  "$id": "/properties/credentials/properties/parameters/sharedKeyName#az-sasl",
+                  "type": "string",
+                  "title": "Shared key name",
+                  "description": "Name of the used sharedKey"
+                },
+                "endpoint": {
+                  "$id": "/properties/credentials/properties/parameters/endpoint#az-sasl",
+                  "type": "string",
+                  "title": "Endpoint",
+                  "description": "The endpoint which is used in the signature. For Azure IoT Hub this is expected to be the resourceUri without protocol (e.g. myHub.azure-devices.net). For Azure Service Bus, this is expected to be the full URI of the resource to which access is claimed (e.g. https://myNamespace.servicebus.windows.net/myQueue)."
+                },
+                "ttl": {
+                  "$id": "/properties/credentials/properties/parameters/ttl#az-sasl",
+                  "type": "string",
+                  "title": "TTL",
+                  "description": "The time to live of a signature as a string in duration format. Allowed time units are “ms” (milliseconds), “s” (seconds), “m” (minutes) and “h” (hours), e.g. “10m” for ten minutes. ttl should only be set for AMQP connections and defines how long the connection signing is valid. The broker (e.g. Azure IoT Hub) will close the connection after ttl and Ditto will reconnect with a new signature. Defaults to 7 days.",
+                  "default": "168h"
+                }
+              }
+            }
+          }
         }
-      }
+      ]
     },
     "sources": {
       "$id": "/properties/sources",
@@ -156,7 +363,10 @@
                 "type": "string",
                 "title": "Input value of enforcement",
                 "description": "The input value of the enforcement that should identify the origin of the message (e.g. a device id). Placeholders can be used within this field depending on the connection type. E.g. for AMQP 1.0 connections you can use `{{ header:[any-header-name] }}` to resolve the value from a message header.",
-                "examples": ["{{ header:device_id }}", "{{ source:address }}"]
+                "examples": [
+                  "{{ header:device_id }}",
+                  "{{ source:address }}"
+                ]
               },
               "filters": {
                 "$id": "/properties/sources/items/properties/enforcement/filters",
@@ -254,7 +464,10 @@
                 "type": "string",
                 "title": "Reply target address",
                 "description": "The target address where responses of incoming commands from the parent source are published to. The following placeholders are allowed within the target address:\n * Thing ID: `{{ thing:id }}`\n * Thing Namespace: `{{ thing:namespace }}`\n * Thing Name: `{{ thing:name }}` (the part of the ID without the namespace)\n * Ditto protocol topic attribute: `{{ topic:[topic-placeholder-attr] }}`\n * Ditto protocol header value: `{{ header:[any-header-name] }}`\n\nIf placeholder resolution fails for a response, then the response is dropped.",
-                "examples": ["{{ header:device_id }}", "{{ source:address }}"]
+                "examples": [
+                  "{{ header:device_id }}",
+                  "{{ source:address }}"
+                ]
               },
               "headerMapping": {
                 "$id": "/properties/sources/items/properties/replyTarget/headerMapping",
@@ -395,7 +608,9 @@
       "minimum": 1,
       "maximum": "#clusterNodes",
       "examples": [
-        1,2,3
+        1,
+        2,
+        3
       ]
     },
     "failoverEnabled": {
@@ -420,7 +635,11 @@
       "default": 5,
       "minimum": 1,
       "examples": [
-        1,2,3,5,8
+        1,
+        2,
+        3,
+        5,
+        8
       ]
     },
     "specificConfig": {
@@ -578,5 +797,11 @@
     }
   },
   "additionalProperties": false,
-  "required": [ "id", "connectionType", "connectionStatus", "uri", "authorizationContext"]
+  "required": [
+    "id",
+    "connectionType",
+    "connectionStatus",
+    "uri",
+    "authorizationContext"
+  ]
 }
diff --git a/presentations.html b/presentations.html
index 0201a2e..cff4f7e 100644
--- a/presentations.html
+++ b/presentations.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1731,6 +1781,12 @@
 
   <p>This page contains a collection of presentations, videos and workshops about Eclipse Ditto, sorted from most recent ones downwards.</p>
 
+<h2 id="22062021-eclipse-iot-workinggroup-status-update">22.06.2021 Eclipse IoT WorkingGroup status update</h2>
+
+<p>Topic: Eclipse Ditto™ 2.0: Changes and roadmap</p>
+
+<p>The slides can be found here: <a href="slides/2021_06_ditto-20-overview/index.html">2021_06_ditto-20-overview</a>.</p>
+
 <h2 id="19102020-eclipsecon-europe-2020-community-day">19.10.2020 EclipseCon Europe 2020 Community Day</h2>
 
 <p>Topic: Project status update of Eclipse Ditto</p>
@@ -1803,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-bindings.html b/protocol-bindings.html
index a0f2c8f..b15ec24 100644
--- a/protocol-bindings.html
+++ b/protocol-bindings.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li class="active"><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-connections-announcement-closed.html b/protocol-examples-connections-announcement-closed.html
new file mode 100644
index 0000000..3bf8c8d
--- /dev/null
+++ b/protocol-examples-connections-announcement-closed.html
@@ -0,0 +1,1851 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, connection, connectivity, announcement, closed">
+<title>  ConnectionClosedAnnouncement • Eclipse Ditto™ • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="ConnectionClosedAnnouncement">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+            <!-- Sidebar Column -->
+            <div class="col-md-3" id="tg-sb-sidebar">
+                
+
+<ul id="mysidebar" class="nav">
+  <li class="sidebarTitle">
+    <label for="docVersion">Eclipse Ditto™ version:</label>
+    <div class="select-wrapper">
+      <select id="docVersion" name="docVersion">
+        
+        <option value="">development</option>
+        
+        <option value="2.0">2.0</option>
+        
+        <option value="1.5">1.5</option>
+        
+        <option value="1.4">1.4</option>
+        
+        <option value="1.3">1.3</option>
+        
+        <option value="1.2">1.2</option>
+        
+        <option value="1.1">1.1</option>
+        
+        <option value="1.0">1.0</option>
+        
+      </select>
+    </div>
+    <div id="dev-warning">
+      <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+    </div>
+  </li>
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Introduction</a>
+          <ul>
+              
+              
+              
+              <li><a href="intro-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-hello-world.html">Hello world</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Release Notes</a>
+          <ul>
+              
+              
+              
+              <li><a href="release_notes_201.html">2.0.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_200.html">2.0.0</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_151.html">1.5.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_150.html">1.5.0</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Archive</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="release_notes_140.html">1.4.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_130.html">1.3.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_121.html">1.2.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_120.html">1.2.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_115.html">1.1.5</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_113.html">1.1.3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_112.html">1.1.2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_111.html">1.1.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_110.html">1.1.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100.html">1.0.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090.html">0.9.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080.html">0.8.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Installation</a>
+          <ul>
+              
+              
+              
+              <li><a href="installation-building.html">Building Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-running.html">Running Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-operating.html">Operating Ditto</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Basic concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="basic-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Model entities</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-thing.html">Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-feature.html">Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-policy.html">Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-metadata.html">Thing Metadata</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-errors.html">Errors</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-signals.html">Signals</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Signal types</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-signals-command.html">Command</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-event.html">Event</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-apis.html">APIs</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-connections.html">Connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-placeholders.html">Placeholders</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-changenotifications.html">Change notifications</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-rql.html">RQL expressions</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Advanced concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Architecture</a>
+          <ul>
+              
+              
+              
+              <li><a href="architecture-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Services</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="architecture-services-policies.html">Policies</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things.html">Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-concierge.html">Concierge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-gateway.html">Gateway</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>HTTP API</a>
+          <ul>
+              
+              
+              
+              <li><a href="httpapi-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-concepts.html">Concepts</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-sse.html">Server sent events</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Connectivity API</a>
+          <ul>
+              
+              
+              
+              <li><a href="connectivity-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Client SDK</a>
+          <ul>
+              
+              
+              
+              <li><a href="client-sdk-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-java.html">Java</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Ditto Protocol</a>
+          <ul>
+              
+              
+              
+              <li><a href="protocol-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification.html">Specification</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-errors.html">Errors</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-things.html">Things group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/events</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-merge.html">Merge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ search/messages</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-search.html">Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-policies.html">Policies group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-bindings.html">Bindings</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples.html">Examples</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things merge examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Policies examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li class="active"><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+    <li><a href="sandbox.html">Sandbox</a></li>
+    
+  
+  
+  
+    
+    <li><a href="presentations.html">Presentations</a></li>
+    
+  
+  
+  
+    
+    <li><a href="glossary.html">Glossary</a></li>
+    
+  
+  
+  
+    
+    <li><a href="feedback.html">Feedback</a></li>
+    
+  
+  
+  
+    
+         <p class="external">
+             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+         </p>
+    
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+</script>
+
+            </div>
+            
+        
+
+        <!-- Content Column -->
+        <div class="col-md-9" id="tg-sb-content">
+            <div class="post-header">
+   <h1 class="post-title-main">ConnectionClosedAnnouncement</h1>
+</div>
+
+
+
+<div class="post-content">
+
+   
+
+    
+    
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+    
+
+
+    
+
+
+    
+
+  
+<h2 id="connectionclosedannouncement">ConnectionClosedAnnouncement</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/the_connection_id/connections/announcements/closed"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/json"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"closedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-03-03T16:05:55Z"</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+    <div class="tags">
+        
+    </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/protocol-examples-connections-announcement-opened.html b/protocol-examples-connections-announcement-opened.html
new file mode 100644
index 0000000..f5a91aa
--- /dev/null
+++ b/protocol-examples-connections-announcement-opened.html
@@ -0,0 +1,1851 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content=" examples, connection, connectivity, announcement, opened">
+<title>  ConnectionClosedAnnouncement • Eclipse Ditto™ • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="ConnectionClosedAnnouncement">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+            <!-- Sidebar Column -->
+            <div class="col-md-3" id="tg-sb-sidebar">
+                
+
+<ul id="mysidebar" class="nav">
+  <li class="sidebarTitle">
+    <label for="docVersion">Eclipse Ditto™ version:</label>
+    <div class="select-wrapper">
+      <select id="docVersion" name="docVersion">
+        
+        <option value="">development</option>
+        
+        <option value="2.0">2.0</option>
+        
+        <option value="1.5">1.5</option>
+        
+        <option value="1.4">1.4</option>
+        
+        <option value="1.3">1.3</option>
+        
+        <option value="1.2">1.2</option>
+        
+        <option value="1.1">1.1</option>
+        
+        <option value="1.0">1.0</option>
+        
+      </select>
+    </div>
+    <div id="dev-warning">
+      <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+    </div>
+  </li>
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Introduction</a>
+          <ul>
+              
+              
+              
+              <li><a href="intro-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-hello-world.html">Hello world</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Release Notes</a>
+          <ul>
+              
+              
+              
+              <li><a href="release_notes_201.html">2.0.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_200.html">2.0.0</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_151.html">1.5.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_150.html">1.5.0</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Archive</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="release_notes_140.html">1.4.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_130.html">1.3.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_121.html">1.2.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_120.html">1.2.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_115.html">1.1.5</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_113.html">1.1.3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_112.html">1.1.2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_111.html">1.1.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_110.html">1.1.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100.html">1.0.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090.html">0.9.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080.html">0.8.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Installation</a>
+          <ul>
+              
+              
+              
+              <li><a href="installation-building.html">Building Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-running.html">Running Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-operating.html">Operating Ditto</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Basic concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="basic-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Model entities</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-thing.html">Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-feature.html">Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-policy.html">Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-metadata.html">Thing Metadata</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-errors.html">Errors</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-signals.html">Signals</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Signal types</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-signals-command.html">Command</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-event.html">Event</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-apis.html">APIs</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-connections.html">Connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-placeholders.html">Placeholders</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-changenotifications.html">Change notifications</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-rql.html">RQL expressions</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Advanced concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Architecture</a>
+          <ul>
+              
+              
+              
+              <li><a href="architecture-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Services</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="architecture-services-policies.html">Policies</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things.html">Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-concierge.html">Concierge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-gateway.html">Gateway</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>HTTP API</a>
+          <ul>
+              
+              
+              
+              <li><a href="httpapi-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-concepts.html">Concepts</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-sse.html">Server sent events</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Connectivity API</a>
+          <ul>
+              
+              
+              
+              <li><a href="connectivity-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Client SDK</a>
+          <ul>
+              
+              
+              
+              <li><a href="client-sdk-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-java.html">Java</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Ditto Protocol</a>
+          <ul>
+              
+              
+              
+              <li><a href="protocol-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification.html">Specification</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-errors.html">Errors</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-things.html">Things group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/events</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-merge.html">Merge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ search/messages</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-search.html">Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-policies.html">Policies group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-bindings.html">Bindings</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples.html">Examples</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things merge examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Policies examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li class="active"><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+    <li><a href="sandbox.html">Sandbox</a></li>
+    
+  
+  
+  
+    
+    <li><a href="presentations.html">Presentations</a></li>
+    
+  
+  
+  
+    
+    <li><a href="glossary.html">Glossary</a></li>
+    
+  
+  
+  
+    
+    <li><a href="feedback.html">Feedback</a></li>
+    
+  
+  
+  
+    
+         <p class="external">
+             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+         </p>
+    
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+</script>
+
+            </div>
+            
+        
+
+        <!-- Content Column -->
+        <div class="col-md-9" id="tg-sb-content">
+            <div class="post-header">
+   <h1 class="post-title-main">ConnectionClosedAnnouncement</h1>
+</div>
+
+
+
+<div class="post-content">
+
+   
+
+    
+    
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+    
+
+
+    
+
+
+    
+
+  
+<h2 id="connectionopenedannouncement">ConnectionOpenedAnnouncement</h2>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+  </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"_/the_connection_id/connections/announcements/opened"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"headers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/json"</span><span class="w">
+  </span><span class="p">},</span><span class="w">
+  </span><span class="s2">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/"</span><span class="p">,</span><span class="w">
+  </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+    </span><span class="s2">"openedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-03-03T16:05:55Z"</span><span class="w">
+  </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+
+
+    <div class="tags">
+        
+    </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/protocol-examples-createattribute.html b/protocol-examples-createattribute.html
index 0ee1c86..03f88f0 100644
--- a/protocol-examples-createattribute.html
+++ b/protocol-examples-createattribute.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1791,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createattributes.html b/protocol-examples-createattributes.html
index 09ce2d0..6df807b 100644
--- a/protocol-examples-createattributes.html
+++ b/protocol-examples-createattributes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1796,7 +1846,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdefinition.html b/protocol-examples-createdefinition.html
index 8bcc18c..adcab84 100644
--- a/protocol-examples-createdefinition.html
+++ b/protocol-examples-createdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1789,7 +1839,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdesiredproperties.html b/protocol-examples-createdesiredproperties.html
index e80e903..d1278e0 100644
--- a/protocol-examples-createdesiredproperties.html
+++ b/protocol-examples-createdesiredproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1794,7 +1844,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdesiredproperty.html b/protocol-examples-createdesiredproperty.html
index 916b04d..ac9714d 100644
--- a/protocol-examples-createdesiredproperty.html
+++ b/protocol-examples-createdesiredproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1784,7 +1834,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createfeature.html b/protocol-examples-createfeature.html
index e0b6ca7..48e5cee 100644
--- a/protocol-examples-createfeature.html
+++ b/protocol-examples-createfeature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1812,7 +1862,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createfeatures.html b/protocol-examples-createfeatures.html
index cb72f25..e2ff86a 100644
--- a/protocol-examples-createfeatures.html
+++ b/protocol-examples-createfeatures.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createproperties.html b/protocol-examples-createproperties.html
index 41139b4..5f74384 100644
--- a/protocol-examples-createproperties.html
+++ b/protocol-examples-createproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1795,7 +1845,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createproperty.html b/protocol-examples-createproperty.html
index 1c6c645..9d98387 100644
--- a/protocol-examples-createproperty.html
+++ b/protocol-examples-createproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1785,7 +1835,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-creatething.html b/protocol-examples-creatething.html
index 7326604..7ce7585 100644
--- a/protocol-examples-creatething.html
+++ b/protocol-examples-creatething.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1900,7 +1950,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createthingdefinition.html b/protocol-examples-createthingdefinition.html
index 362c5cd..e2027bc 100644
--- a/protocol-examples-createthingdefinition.html
+++ b/protocol-examples-createthingdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1786,7 +1836,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteattribute.html b/protocol-examples-deleteattribute.html
index 59dea6f..ab33336 100644
--- a/protocol-examples-deleteattribute.html
+++ b/protocol-examples-deleteattribute.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteattributes.html b/protocol-examples-deleteattributes.html
index e90689e..4f1af20 100644
--- a/protocol-examples-deleteattributes.html
+++ b/protocol-examples-deleteattributes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedefinition.html b/protocol-examples-deletedefinition.html
index ee385c2..ebf1c14 100644
--- a/protocol-examples-deletedefinition.html
+++ b/protocol-examples-deletedefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedesiredproperties.html b/protocol-examples-deletedesiredproperties.html
index baff6d8..34c45e4 100644
--- a/protocol-examples-deletedesiredproperties.html
+++ b/protocol-examples-deletedesiredproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1782,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedesiredproperty.html b/protocol-examples-deletedesiredproperty.html
index 27efac1..f69dab5 100644
--- a/protocol-examples-deletedesiredproperty.html
+++ b/protocol-examples-deletedesiredproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1782,7 +1832,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletefeature.html b/protocol-examples-deletefeature.html
index 7ef7890..9adb42f 100644
--- a/protocol-examples-deletefeature.html
+++ b/protocol-examples-deletefeature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletefeatures.html b/protocol-examples-deletefeatures.html
index dc55124..9808d5b 100644
--- a/protocol-examples-deletefeatures.html
+++ b/protocol-examples-deletefeatures.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteproperties.html b/protocol-examples-deleteproperties.html
index 553ffe9..edd49c2 100644
--- a/protocol-examples-deleteproperties.html
+++ b/protocol-examples-deleteproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deleteproperty.html b/protocol-examples-deleteproperty.html
index 7d37969..f7f14c8 100644
--- a/protocol-examples-deleteproperty.html
+++ b/protocol-examples-deleteproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletething.html b/protocol-examples-deletething.html
index 67d121a..00f06cd 100644
--- a/protocol-examples-deletething.html
+++ b/protocol-examples-deletething.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletethingdefinition.html b/protocol-examples-deletethingdefinition.html
index 2c939a0..2274315 100644
--- a/protocol-examples-deletethingdefinition.html
+++ b/protocol-examples-deletethingdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1783,7 +1833,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-errorresponses.html b/protocol-examples-errorresponses.html
index 765f697..644fd4c 100644
--- a/protocol-examples-errorresponses.html
+++ b/protocol-examples-errorresponses.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2260,7 +2310,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeattribute.html b/protocol-examples-mergeattribute.html
index 0f0579d..58dc4f3 100644
--- a/protocol-examples-mergeattribute.html
+++ b/protocol-examples-mergeattribute.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1805,7 +1855,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeattributes.html b/protocol-examples-mergeattributes.html
index 9409f11..1e52ccc 100644
--- a/protocol-examples-mergeattributes.html
+++ b/protocol-examples-mergeattributes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1809,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergedesiredproperties.html b/protocol-examples-mergedesiredproperties.html
index bf599c3..7c0be0c 100644
--- a/protocol-examples-mergedesiredproperties.html
+++ b/protocol-examples-mergedesiredproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1809,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergedesiredproperty.html b/protocol-examples-mergedesiredproperty.html
index ede0c92..7f3c41a 100644
--- a/protocol-examples-mergedesiredproperty.html
+++ b/protocol-examples-mergedesiredproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1799,7 +1849,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeature.html b/protocol-examples-mergefeature.html
index 63e0209..4e6e8ff 100644
--- a/protocol-examples-mergefeature.html
+++ b/protocol-examples-mergefeature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1819,7 +1869,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeaturedefinition.html b/protocol-examples-mergefeaturedefinition.html
index 960f8ab..1107582 100644
--- a/protocol-examples-mergefeaturedefinition.html
+++ b/protocol-examples-mergefeaturedefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1803,7 +1853,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeatures.html b/protocol-examples-mergefeatures.html
index 7d97e2c..2ae19ea 100644
--- a/protocol-examples-mergefeatures.html
+++ b/protocol-examples-mergefeatures.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1823,7 +1873,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergepolicyid.html b/protocol-examples-mergepolicyid.html
index f26b1ba..40ab44a 100644
--- a/protocol-examples-mergepolicyid.html
+++ b/protocol-examples-mergepolicyid.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1786,7 +1836,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeproperties.html b/protocol-examples-mergeproperties.html
index 8fa7590..919e627 100644
--- a/protocol-examples-mergeproperties.html
+++ b/protocol-examples-mergeproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1809,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeproperty.html b/protocol-examples-mergeproperty.html
index 41ed03f..388cb92 100644
--- a/protocol-examples-mergeproperty.html
+++ b/protocol-examples-mergeproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1799,7 +1849,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergething.html b/protocol-examples-mergething.html
index b328021..b79d39a 100644
--- a/protocol-examples-mergething.html
+++ b/protocol-examples-mergething.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1832,7 +1882,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergethingdefinition.html b/protocol-examples-mergethingdefinition.html
index e7fd82e..43074bb 100644
--- a/protocol-examples-mergethingdefinition.html
+++ b/protocol-examples-mergethingdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1799,7 +1849,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyattribute.html b/protocol-examples-modifyattribute.html
index df409c7..375ac00 100644
--- a/protocol-examples-modifyattribute.html
+++ b/protocol-examples-modifyattribute.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1791,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyattributes.html b/protocol-examples-modifyattributes.html
index c846bce..0f63116 100644
--- a/protocol-examples-modifyattributes.html
+++ b/protocol-examples-modifyattributes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1796,7 +1846,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydefinition.html b/protocol-examples-modifydefinition.html
index e29aa3e..e134725 100644
--- a/protocol-examples-modifydefinition.html
+++ b/protocol-examples-modifydefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1789,7 +1839,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydesiredproperties.html b/protocol-examples-modifydesiredproperties.html
index 5162976..95e7f49 100644
--- a/protocol-examples-modifydesiredproperties.html
+++ b/protocol-examples-modifydesiredproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1794,7 +1844,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydesiredproperty.html b/protocol-examples-modifydesiredproperty.html
index dee4ced..895fdb8 100644
--- a/protocol-examples-modifydesiredproperty.html
+++ b/protocol-examples-modifydesiredproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1784,7 +1834,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyfeature.html b/protocol-examples-modifyfeature.html
index 3c42317..223e3e5 100644
--- a/protocol-examples-modifyfeature.html
+++ b/protocol-examples-modifyfeature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1812,7 +1862,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyfeatures.html b/protocol-examples-modifyfeatures.html
index 7e9e254..f27306d 100644
--- a/protocol-examples-modifyfeatures.html
+++ b/protocol-examples-modifyfeatures.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifypolicyid.html b/protocol-examples-modifypolicyid.html
index 5ec38aa..2287337 100644
--- a/protocol-examples-modifypolicyid.html
+++ b/protocol-examples-modifypolicyid.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1811,7 +1861,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyproperties.html b/protocol-examples-modifyproperties.html
index db7e0c2..648e363 100644
--- a/protocol-examples-modifyproperties.html
+++ b/protocol-examples-modifyproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1795,7 +1845,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifyproperty.html b/protocol-examples-modifyproperty.html
index 31fa863..a43c6fe 100644
--- a/protocol-examples-modifyproperty.html
+++ b/protocol-examples-modifyproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1785,7 +1835,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifything.html b/protocol-examples-modifything.html
index c7ac2c3..74ceabf 100644
--- a/protocol-examples-modifything.html
+++ b/protocol-examples-modifything.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1881,7 +1931,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifythingdefinition.html b/protocol-examples-modifythingdefinition.html
index a8afdc5..e53fa70 100644
--- a/protocol-examples-modifythingdefinition.html
+++ b/protocol-examples-modifythingdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1785,7 +1835,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-announcement-subjectDeletion.html b/protocol-examples-policies-announcement-subjectDeletion.html
index 2e0881c..a91bd20 100644
--- a/protocol-examples-policies-announcement-subjectDeletion.html
+++ b/protocol-examples-policies-announcement-subjectDeletion.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1766,7 +1816,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createpolicy.html b/protocol-examples-policies-createpolicy.html
index 5c7d445..2e70d9e 100644
--- a/protocol-examples-policies-createpolicy.html
+++ b/protocol-examples-policies-createpolicy.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1813,7 +1863,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createpolicyentry.html b/protocol-examples-policies-createpolicyentry.html
index 1421a15..e07ab34 100644
--- a/protocol-examples-policies-createpolicyentry.html
+++ b/protocol-examples-policies-createpolicyentry.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1789,7 +1839,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createresource.html b/protocol-examples-policies-createresource.html
index 9373427..fe98274 100644
--- a/protocol-examples-policies-createresource.html
+++ b/protocol-examples-policies-createresource.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1778,7 +1828,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-createsubject.html b/protocol-examples-policies-createsubject.html
index 8552cb4..43ec34a 100644
--- a/protocol-examples-policies-createsubject.html
+++ b/protocol-examples-policies-createsubject.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1774,7 +1824,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletepolicy.html b/protocol-examples-policies-deletepolicy.html
index 611a31b..748beb1 100644
--- a/protocol-examples-policies-deletepolicy.html
+++ b/protocol-examples-policies-deletepolicy.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletepolicyentry.html b/protocol-examples-policies-deletepolicyentry.html
index 108785c..4bd4eb8 100644
--- a/protocol-examples-policies-deletepolicyentry.html
+++ b/protocol-examples-policies-deletepolicyentry.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deleteresource.html b/protocol-examples-policies-deleteresource.html
index 8d20200..3933724 100644
--- a/protocol-examples-policies-deleteresource.html
+++ b/protocol-examples-policies-deleteresource.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-deletesubject.html b/protocol-examples-policies-deletesubject.html
index be2a088..063bf2e 100644
--- a/protocol-examples-policies-deletesubject.html
+++ b/protocol-examples-policies-deletesubject.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-errorresponses.html b/protocol-examples-policies-errorresponses.html
index 476986c..21a56c0 100644
--- a/protocol-examples-policies-errorresponses.html
+++ b/protocol-examples-policies-errorresponses.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2114,7 +2164,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicy.html b/protocol-examples-policies-modifypolicy.html
index 0171809..64c98f8 100644
--- a/protocol-examples-policies-modifypolicy.html
+++ b/protocol-examples-policies-modifypolicy.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1792,7 +1842,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicyentries.html b/protocol-examples-policies-modifypolicyentries.html
index 81dc347..abde041 100644
--- a/protocol-examples-policies-modifypolicyentries.html
+++ b/protocol-examples-policies-modifypolicyentries.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1811,7 +1861,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifypolicyentry.html b/protocol-examples-policies-modifypolicyentry.html
index 99d7d68..f428125 100644
--- a/protocol-examples-policies-modifypolicyentry.html
+++ b/protocol-examples-policies-modifypolicyentry.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1789,7 +1839,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifyresource.html b/protocol-examples-policies-modifyresource.html
index 79dac57..d0b320c 100644
--- a/protocol-examples-policies-modifyresource.html
+++ b/protocol-examples-policies-modifyresource.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1778,7 +1828,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifyresources.html b/protocol-examples-policies-modifyresources.html
index da029c6..9a1a48a 100644
--- a/protocol-examples-policies-modifyresources.html
+++ b/protocol-examples-policies-modifyresources.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1781,7 +1831,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifysubject.html b/protocol-examples-policies-modifysubject.html
index 67165cf..6df2aac 100644
--- a/protocol-examples-policies-modifysubject.html
+++ b/protocol-examples-policies-modifysubject.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1774,7 +1824,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-modifysubjects.html b/protocol-examples-policies-modifysubjects.html
index d42039a..a5112c9 100644
--- a/protocol-examples-policies-modifysubjects.html
+++ b/protocol-examples-policies-modifysubjects.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1777,7 +1827,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicy.html b/protocol-examples-policies-retrievepolicy.html
index a9182f0..55fff64 100644
--- a/protocol-examples-policies-retrievepolicy.html
+++ b/protocol-examples-policies-retrievepolicy.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1792,7 +1842,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicyentries.html b/protocol-examples-policies-retrievepolicyentries.html
index 0ce59f7..82a9cc6 100644
--- a/protocol-examples-policies-retrievepolicyentries.html
+++ b/protocol-examples-policies-retrievepolicyentries.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1805,7 +1855,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievepolicyentry.html b/protocol-examples-policies-retrievepolicyentry.html
index e928dc7..9289740 100644
--- a/protocol-examples-policies-retrievepolicyentry.html
+++ b/protocol-examples-policies-retrievepolicyentry.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1787,7 +1837,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrieveresource.html b/protocol-examples-policies-retrieveresource.html
index 8756bd3..82655f8 100644
--- a/protocol-examples-policies-retrieveresource.html
+++ b/protocol-examples-policies-retrieveresource.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1778,7 +1828,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrieveresources.html b/protocol-examples-policies-retrieveresources.html
index d16b0e4..8936380 100644
--- a/protocol-examples-policies-retrieveresources.html
+++ b/protocol-examples-policies-retrieveresources.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1780,7 +1830,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievesubject.html b/protocol-examples-policies-retrievesubject.html
index cc824c6..fdd1fc8 100644
--- a/protocol-examples-policies-retrievesubject.html
+++ b/protocol-examples-policies-retrievesubject.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1774,7 +1824,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-retrievesubjects.html b/protocol-examples-policies-retrievesubjects.html
index 436eef1..24b07ae 100644
--- a/protocol-examples-policies-retrievesubjects.html
+++ b/protocol-examples-policies-retrievesubjects.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1776,7 +1826,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveattribute.html b/protocol-examples-retrieveattribute.html
index 0970124..b1d8ef8 100644
--- a/protocol-examples-retrieveattribute.html
+++ b/protocol-examples-retrieveattribute.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1775,7 +1825,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveattributes.html b/protocol-examples-retrieveattributes.html
index c7850db..eb55e13 100644
--- a/protocol-examples-retrieveattributes.html
+++ b/protocol-examples-retrieveattributes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1777,7 +1827,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedefinition.html b/protocol-examples-retrievedefinition.html
index 93ea78f..7a75d3d 100644
--- a/protocol-examples-retrievedefinition.html
+++ b/protocol-examples-retrievedefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1774,7 +1824,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedesiredproperties.html b/protocol-examples-retrievedesiredproperties.html
index 654b0f0..77ddfbe 100644
--- a/protocol-examples-retrievedesiredproperties.html
+++ b/protocol-examples-retrievedesiredproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1776,7 +1826,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedesiredproperty.html b/protocol-examples-retrievedesiredproperty.html
index 1ff33fe..2166342 100644
--- a/protocol-examples-retrievedesiredproperty.html
+++ b/protocol-examples-retrievedesiredproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievefeature.html b/protocol-examples-retrievefeature.html
index 3025b01..87ac641 100644
--- a/protocol-examples-retrievefeature.html
+++ b/protocol-examples-retrievefeature.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1785,7 +1835,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievefeatures.html b/protocol-examples-retrievefeatures.html
index 75d3bf2..b3c334a 100644
--- a/protocol-examples-retrievefeatures.html
+++ b/protocol-examples-retrievefeatures.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1787,7 +1837,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveproperties.html b/protocol-examples-retrieveproperties.html
index a08c070..6936b84 100644
--- a/protocol-examples-retrieveproperties.html
+++ b/protocol-examples-retrieveproperties.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1777,7 +1827,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrieveproperty.html b/protocol-examples-retrieveproperty.html
index 0aa5e94..1e03c74 100644
--- a/protocol-examples-retrieveproperty.html
+++ b/protocol-examples-retrieveproperty.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1772,7 +1822,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievething.html b/protocol-examples-retrievething.html
index b08b012..cdf8911 100644
--- a/protocol-examples-retrievething.html
+++ b/protocol-examples-retrievething.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1809,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievethingdefinition.html b/protocol-examples-retrievethingdefinition.html
index efff998..68beae9 100644
--- a/protocol-examples-retrievethingdefinition.html
+++ b/protocol-examples-retrievethingdefinition.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1772,7 +1822,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievethings.html b/protocol-examples-retrievethings.html
index 52408aa..c3700f2 100644
--- a/protocol-examples-retrievethings.html
+++ b/protocol-examples-retrievethings.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1804,7 +1854,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-search.html b/protocol-examples-search.html
index 5bab8ef..5793494 100644
--- a/protocol-examples-search.html
+++ b/protocol-examples-search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1872,7 +1922,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples.html b/protocol-examples.html
index 7f1706d..fd2ca45 100644
--- a/protocol-examples.html
+++ b/protocol-examples.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1857,7 +1907,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-overview.html b/protocol-overview.html
index cf33bd3..058b0ed 100644
--- a/protocol-overview.html
+++ b/protocol-overview.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1770,7 +1820,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-acks.html b/protocol-specification-acks.html
index 7a883b4..cbba300 100644
--- a/protocol-specification-acks.html
+++ b/protocol-specification-acks.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1794,7 +1844,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-connections-announcement.html b/protocol-specification-connections-announcement.html
new file mode 100644
index 0000000..fbdc2e6
--- /dev/null
+++ b/protocol-specification-connections-announcement.html
@@ -0,0 +1,1918 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol,  protocol, specification, announcement, connection, connections, connectivity">
+<title>  Connections - Announcement protocol specification • Eclipse Ditto™ • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="Connections - Announcement protocol specification">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+            <!-- Sidebar Column -->
+            <div class="col-md-3" id="tg-sb-sidebar">
+                
+
+<ul id="mysidebar" class="nav">
+  <li class="sidebarTitle">
+    <label for="docVersion">Eclipse Ditto™ version:</label>
+    <div class="select-wrapper">
+      <select id="docVersion" name="docVersion">
+        
+        <option value="">development</option>
+        
+        <option value="2.0">2.0</option>
+        
+        <option value="1.5">1.5</option>
+        
+        <option value="1.4">1.4</option>
+        
+        <option value="1.3">1.3</option>
+        
+        <option value="1.2">1.2</option>
+        
+        <option value="1.1">1.1</option>
+        
+        <option value="1.0">1.0</option>
+        
+      </select>
+    </div>
+    <div id="dev-warning">
+      <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+    </div>
+  </li>
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Introduction</a>
+          <ul>
+              
+              
+              
+              <li><a href="intro-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-hello-world.html">Hello world</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Release Notes</a>
+          <ul>
+              
+              
+              
+              <li><a href="release_notes_201.html">2.0.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_200.html">2.0.0</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_151.html">1.5.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_150.html">1.5.0</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Archive</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="release_notes_140.html">1.4.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_130.html">1.3.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_121.html">1.2.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_120.html">1.2.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_115.html">1.1.5</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_113.html">1.1.3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_112.html">1.1.2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_111.html">1.1.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_110.html">1.1.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100.html">1.0.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090.html">0.9.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080.html">0.8.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Installation</a>
+          <ul>
+              
+              
+              
+              <li><a href="installation-building.html">Building Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-running.html">Running Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-operating.html">Operating Ditto</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Basic concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="basic-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Model entities</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-thing.html">Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-feature.html">Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-policy.html">Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-metadata.html">Thing Metadata</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-errors.html">Errors</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-signals.html">Signals</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Signal types</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-signals-command.html">Command</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-event.html">Event</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-apis.html">APIs</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-connections.html">Connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-placeholders.html">Placeholders</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-changenotifications.html">Change notifications</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-rql.html">RQL expressions</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Advanced concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Architecture</a>
+          <ul>
+              
+              
+              
+              <li><a href="architecture-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Services</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="architecture-services-policies.html">Policies</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things.html">Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-concierge.html">Concierge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-gateway.html">Gateway</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>HTTP API</a>
+          <ul>
+              
+              
+              
+              <li><a href="httpapi-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-concepts.html">Concepts</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-sse.html">Server sent events</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Connectivity API</a>
+          <ul>
+              
+              
+              
+              <li><a href="connectivity-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Client SDK</a>
+          <ul>
+              
+              
+              
+              <li><a href="client-sdk-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-java.html">Java</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Ditto Protocol</a>
+          <ul>
+              
+              
+              
+              <li><a href="protocol-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification.html">Specification</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-errors.html">Errors</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-things.html">Things group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/events</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-merge.html">Merge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ search/messages</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-search.html">Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-policies.html">Policies group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li class="active"><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-bindings.html">Bindings</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples.html">Examples</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things merge examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Policies examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+    <li><a href="sandbox.html">Sandbox</a></li>
+    
+  
+  
+  
+    
+    <li><a href="presentations.html">Presentations</a></li>
+    
+  
+  
+  
+    
+    <li><a href="glossary.html">Glossary</a></li>
+    
+  
+  
+  
+    
+    <li><a href="feedback.html">Feedback</a></li>
+    
+  
+  
+  
+    
+         <p class="external">
+             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+         </p>
+    
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+</script>
+
+            </div>
+            
+        
+
+        <!-- Content Column -->
+        <div class="col-md-9" id="tg-sb-content">
+            <div class="post-header">
+   <h1 class="post-title-main">Connections - Announcement protocol specification</h1>
+</div>
+
+
+
+<div class="post-content">
+
+   
+
+    
+    
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+    
+
+
+    
+
+
+    
+
+  <div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The <em>topic path</em> of connection announcements contains a <em>_</em> (underscore) as <em>namespace</em> 
+and no <em>channel</em> element. 
+See the <a href="protocol-specification-connections.html#ditto-protocol-topic-structure-for-connections">specification</a> for 
+details. </div>
+
+<h2 id="connection-announcements">Connection announcements</h2>
+
+<p>A connection announcement contains the announcement name as last part of the topic:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_/&lt;connectionId&gt;/connections/announcements/&lt;announcement-name&gt;
+</code></pre></div></div>
+
+<p>The Ditto Protocol representation of an <code class="highlighter-rouge">Announcement</code> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-announcement.json"></script>
+
+<p>The following Connection announcements are currently supported:</p>
+
+<h3 id="connectionopenedannouncement">ConnectionOpenedAnnouncement</h3>
+
+<p>Announcement indicating that the connection is being opened.</p>
+
+<table>
+  <thead>
+    <tr>
+      <th>Field</th>
+      <th>Value</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><strong>topic</strong></td>
+      <td><code class="highlighter-rouge">_/&lt;connectionId&gt;/connections/announcements/opened</code></td>
+    </tr>
+    <tr>
+      <td><strong>path</strong></td>
+      <td><code class="highlighter-rouge">/</code></td>
+    </tr>
+    <tr>
+      <td><strong>value</strong></td>
+      <td><code class="highlighter-rouge">JsonObject</code> containing<br />* <code class="highlighter-rouge">openedAt</code> timestamp (as ISO-8601 <code class="highlighter-rouge">string</code>)</td>
+    </tr>
+  </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-connections-announcement-opened.html">Announcement for subject deletion</a></p>
+
+<h3 id="connectionclosedannouncement">ConnectionClosedAnnouncement</h3>
+
+<p>Announcement indicating that the connection is being closed gracefully.</p>
+
+<table>
+  <thead>
+    <tr>
+      <th>Field</th>
+      <th>Value</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><strong>topic</strong></td>
+      <td><code class="highlighter-rouge">_/&lt;connectionId&gt;/connections/announcements/closed</code></td>
+    </tr>
+    <tr>
+      <td><strong>path</strong></td>
+      <td><code class="highlighter-rouge">/</code></td>
+    </tr>
+    <tr>
+      <td><strong>value</strong></td>
+      <td><code class="highlighter-rouge">JsonObject</code> containing<br />* <code class="highlighter-rouge">closedAt</code> timestamp (as ISO-8601 <code class="highlighter-rouge">string</code>)</td>
+    </tr>
+  </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-connections-announcement-closed.html">Announcement for subject deletion</a></p>
+
+
+    <div class="tags">
+        
+        <b>Tags: </b>
+        
+        
+        
+        <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+        
+        
+        
+    </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/protocol-specification-connections.html b/protocol-specification-connections.html
new file mode 100644
index 0000000..6bd0efd
--- /dev/null
+++ b/protocol-specification-connections.html
@@ -0,0 +1,1863 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="">
+<meta name="keywords" content="protocol,  protocol, specification, general, connection, connections, connectivity">
+<title>  Protocol specification for connections • Eclipse Ditto™ • a digital twin framework</title>
+
+<link rel="stylesheet" href="css/syntax.css">
+<link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/modern-business.css">
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" crossorigin="anonymous">
+<link rel="stylesheet" href="css/customstyles.css">
+<link rel="stylesheet" href="css/boxshadowproperties.css">
+<link rel="stylesheet" href="css/theme-ditto.css">
+<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700|Source+Code+Pro:300,600|Titillium+Web:400,600,700">
+
+<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/js/bootstrap.min.js" crossorigin="anonymous"></script>
+<script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/2.0.0/anchor.min.js" crossorigin="anonymous"></script>
+<script src="js/toc.js"></script>
+<script src="js/customscripts.js"></script>
+
+<script type="application/ld+json">
+{
+  "@context": "http://schema.org",
+  "@type": "Organization",
+  "url": "https://eclipse.org/ditto/",
+  "logo": "https://eclipse.org/ditto/images/ditto.svg"
+}
+</script>
+
+<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16">
+<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32">
+<link rel="icon" type="image/png" href="images/favicon-96x96.png" sizes="96x96">
+
+<link rel="alternate" type="application/rss+xml" title="Eclipse Ditto Blog" href="https://www.eclipse.org/ditto/feed.xml">
+
+<!-- Eclipse Foundation cookie consent: -->
+<link rel="stylesheet" type="text/css" href="//www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css" />
+<script src="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+    <script>
+        $(document).ready(function() {
+            $("#tg-sb-link").click(function() {
+                $("#tg-sb-sidebar").toggle();
+                $("#tg-sb-content").toggleClass('col-md-9');
+                $("#tg-sb-content").toggleClass('col-md-12');
+                $("#tg-sb-icon").toggleClass('fa-toggle-on');
+                $("#tg-sb-icon").toggleClass('fa-toggle-off');
+            });
+        });
+    </script>
+</head>
+
+
+<script>
+    (function(w,d,s,l,i){
+        w[l]=w[l]||[];
+        w[l].push({'gtm.start':
+            new Date().getTime(),event:'gtm.js'});
+        var f=d.getElementsByTagName(s)[0],
+            j=d.createElement(s),
+            dl=l!='dataLayer'?'&l='+l:'';
+        j.async=true;
+        j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
+        f.parentNode.insertBefore(j,f);
+    })(window,document,'script','dataLayer','GTM-5WLCZXC');
+</script>
+
+
+
+<body>
+<!-- Navigation -->
+<nav class="navbar navbar-inverse navbar-fixed-top">
+    <div class="container topnavlinks">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-ditto-home" href="index.html">&nbsp;<img src="images/ditto_allwhite_symbolonly.svg" class="ditto-navbar-symbol" alt="Home"> <img src="images/ditto_allwhite_textonly.svg" class="ditto-navbar-symbol-text" alt="Eclipse Ditto™"></a>
+        </div>
+        <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
+            <ul class="nav navbar-nav navbar-right">
+                <!-- toggle sidebar button -->
+                <!--<li><a id="tg-sb-link" href="#"><i id="tg-sb-icon" class="fa fa-toggle-on"></i> Nav</a></li>-->
+                <!-- entries without drop-downs appear here -->
+
+
+
+
+                
+                
+                
+                <li><a href="blog.html">Blog</a></li>
+                
+                
+                
+                <li><a href="intro-overview.html">Documentation</a></li>
+                
+                
+                
+                <li><a href="http-api-doc.html">HTTP API</a></li>
+                
+                
+                
+                <li><a href="sandbox.html">Sandbox</a></li>
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+                  </a></li>
+                  
+                
+                
+                
+                  
+                  <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+                    <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at GitHub">examples
+                  </a></li>
+                  
+                
+                
+                
+                <!-- entries with drop-downs appear here -->
+                <!-- conditional logic to control which topnav appears for the audience defined in the configuration file.-->
+                
+                
+                <li class="dropdown">
+                    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Links<b class="caret"></b></a>
+                    <ul class="dropdown-menu">
+                        
+                        
+                        <li><a href="https://projects.eclipse.org/projects/iot.ditto" target="_blank">Eclipse Ditto Project</a></li>
+                        
+                        
+                        
+                        <li><a href="https://www.eclipse.org/forums/index.php/f/364/" target="_blank">Forum</a></li>
+                        
+                        
+                        
+                        <li><a href="https://ci.eclipse.org/ditto/" target="_blank">Jenkins</a></li>
+                        
+                        
+                        
+                        <li><a href="https://dev.eclipse.org/mhonarc/lists/ditto-dev/" target="_blank">Mailing list archives</a></li>
+                        
+                        
+                        
+                        <li><a href="https://gitter.im/eclipse/ditto" target="_blank">Gitter.im chat</a></li>
+                        
+                        
+                    </ul>
+                </li>
+                
+                
+                
+                <!--comment out this block if you want to hide search-->
+                <li>
+                    <!--start search-->
+                    <div id="search-demo-container">
+                        <input type="text" id="search-input" placeholder="search...">
+                        <ul id="results-container"></ul>
+                    </div>
+                    <script src="//cdnjs.cloudflare.com/ajax/libs/simple-jekyll-search/0.0.9/jekyll-search.js" type="text/javascript"></script>
+                    <script type="text/javascript">
+                            SimpleJekyllSearch.init({
+                                searchInput: document.getElementById('search-input'),
+                                resultsContainer: document.getElementById('results-container'),
+                                dataSource: 'search.json',
+                                searchResultTemplate: '<li><a href="{url}" title="Protocol specification for connections">{title}</a></li>',
+                                noResultsText: 'No results found.',
+                                limit: 10,
+                                fuzzy: true,
+                    })
+                    </script>
+                    <!--end search-->
+                </li>
+            </ul>
+        </div>
+    </div>
+    <!-- /.container -->
+</nav>
+
+<!-- Page Content -->
+<div class="container">
+  <div id="main">
+    <!-- Content Row -->
+    <div class="row">
+        
+        
+            <!-- Sidebar Column -->
+            <div class="col-md-3" id="tg-sb-sidebar">
+                
+
+<ul id="mysidebar" class="nav">
+  <li class="sidebarTitle">
+    <label for="docVersion">Eclipse Ditto™ version:</label>
+    <div class="select-wrapper">
+      <select id="docVersion" name="docVersion">
+        
+        <option value="">development</option>
+        
+        <option value="2.0">2.0</option>
+        
+        <option value="1.5">1.5</option>
+        
+        <option value="1.4">1.4</option>
+        
+        <option value="1.3">1.3</option>
+        
+        <option value="1.2">1.2</option>
+        
+        <option value="1.1">1.1</option>
+        
+        <option value="1.0">1.0</option>
+        
+      </select>
+    </div>
+    <div id="dev-warning">
+      <div markdown="span" class="alert alert-warning" role="alert" style="font-size:0.6em"><i class="fa fa-warning"></i> <b>Important:</b> This documentation reflects the latest 'development'. You might want to choose a released version.</div>
+    </div>
+  </li>
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Introduction</a>
+          <ul>
+              
+              
+              
+              <li><a href="intro-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-digitaltwins.html">Digital twins</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="intro-hello-world.html">Hello world</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Release Notes</a>
+          <ul>
+              
+              
+              
+              <li><a href="release_notes_201.html">2.0.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_200.html">2.0.0</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_151.html">1.5.1</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="release_notes_150.html">1.5.0</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Archive</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="release_notes_140.html">1.4.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_130.html">1.3.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_121.html">1.2.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_120.html">1.2.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_115.html">1.1.5</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_113.html">1.1.3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_112.html">1.1.2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_111.html">1.1.1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_110.html">1.1.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100.html">1.0.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090.html">0.9.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080.html">0.8.0</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_100-M1a.html">1.0.0-M1a</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M2.html">0.9.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_090-M1.html">0.9.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M3.html">0.8.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M2.html">0.8.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_080-M1.html">0.8.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M2.html">0.3.0-M2</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_030-M1.html">0.3.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_020-M1.html">0.2.0-M1</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M3.html">0.1.0-M3</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="release_notes_010-M1.html">0.1.0-M1</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Installation</a>
+          <ul>
+              
+              
+              
+              <li><a href="installation-building.html">Building Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-running.html">Running Ditto</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="installation-operating.html">Operating Ditto</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Basic concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="basic-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Model entities</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-thing.html">Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-feature.html">Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-policy.html">Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-metadata.html">Thing Metadata</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-errors.html">Errors</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-signals.html">Signals</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Signal types</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="basic-signals-command.html">Command</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-commandresponse.html">Command response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-errorresponse.html">Error response</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-event.html">Event</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="basic-signals-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-apis.html">APIs</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-connections.html">Connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-placeholders.html">Placeholders</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-changenotifications.html">Change notifications</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-rql.html">RQL expressions</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-enrichment.html">Signal enrichment</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Advanced concepts</a>
+          <ul>
+              
+              
+              
+              <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Architecture</a>
+          <ul>
+              
+              
+              
+              <li><a href="architecture-overview.html">Overview</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>Services</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="architecture-services-policies.html">Policies</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things.html">Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-things-search.html">Things-Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-connectivity.html">Connectivity</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-concierge.html">Concierge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="architecture-services-gateway.html">Gateway</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>HTTP API</a>
+          <ul>
+              
+              
+              
+              <li><a href="httpapi-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-concepts.html">Concepts</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-search.html">Search</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-messages.html">Messages</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="httpapi-sse.html">Server sent events</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Connectivity API</a>
+          <ul>
+              
+              
+              
+              <li><a href="connectivity-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-manage-connections.html">Manage connections</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x protocol binding</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-mapping.html">Payload mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-header-mapping.html">Header mapping</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Client SDK</a>
+          <ul>
+              
+              
+              
+              <li><a href="client-sdk-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-java.html">Java</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+        <li class="subfolders">
+          <a href="#"><span></span>Ditto Protocol</a>
+          <ul>
+              
+              
+              
+              <li><a href="protocol-overview.html">Overview</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-twinlive.html">Twin/live channel</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification.html">Specification</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-errors.html">Errors</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-things.html">Things group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/events</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-merge.html">Merge</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-acks.html">Acknowledgements</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ search/messages</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-search.html">Search</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-things-messages.html">Messages</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-specification-policies.html">Policies group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ commands/announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-create-or-modify.html">Create/Modify</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-retrieve.html">Retrieve</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-delete.html">Delete</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li class="active"><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-bindings.html">Bindings</a></li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples.html">Examples</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-creatething.html">Create a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletething.html">Delete a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifything.html">Modify a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievething.html">Retrieve a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethings.html">Retrieve multiple Things</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifypolicyid.html">Modify the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattributes.html">Create Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattributes.html">Delete Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattributes.html">Modify Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattributes.html">Retrieve Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createattribute.html">Create a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveattribute.html">Retrieve a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createthingdefinition.html">Create a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletethingdefinition.html">Delete a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifythingdefinition.html">Modify a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievethingdefinition.html">Retrieve a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeatures.html">Create Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeatures.html">Delete Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeatures.html">Modify Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeatures.html">Retrieve Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createfeature.html">Create a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletefeature.html">Delete a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievefeature.html">Retrieve a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdefinition.html">Create Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedefinition.html">Retrieve Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperties.html">Create Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperties.html">Retrieve Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createproperty.html">Create a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deleteproperty.html">Delete a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifyproperty.html">Modify a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Things merge examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Policies examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicy.html">Create a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicy.html">Delete a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicy.html">Modify a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicy.html">Retrieve a Policy</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentries.html">Modify entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentries.html">Retrieve entries</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createpolicyentry.html">Create a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletepolicyentry.html">Delete a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifypolicyentry.html">Modify a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievepolicyentry.html">Retrieve a single entry</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubjects.html">Modify subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubjects.html">Retrieve subjects</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createsubject.html">Create a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deletesubject.html">Delete a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifysubject.html">Modify a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrievesubject.html">Retrieve a single subject</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresources.html">Modify resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresources.html">Retrieve resources</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-createresource.html">Create a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-deleteresource.html">Delete a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-modifyresource.html">Modify a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-retrieveresource.html">Retrieve a single resource</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-errorresponses.html">Error responses</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
+              <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+              
+              
+              
+              
+          </ul>
+        </li>
+    
+  
+  
+  
+    
+    <li><a href="sandbox.html">Sandbox</a></li>
+    
+  
+  
+  
+    
+    <li><a href="presentations.html">Presentations</a></li>
+    
+  
+  
+  
+    
+    <li><a href="glossary.html">Glossary</a></li>
+    
+  
+  
+  
+    
+    <li><a href="feedback.html">Feedback</a></li>
+    
+  
+  
+  
+    
+         <p class="external">
+             <a href="#" id="collapseAll">Collapse All</a> | <a href="#" id="expandAll">Expand All</a>
+         </p>
+    
+</ul>
+
+<!-- this highlights the active parent class in the sidebar. this is critical so that the parent expands when you're viewing a page. This must appear below the sidebar code above. Otherwise, if placed inside customscripts.js, the script runs before the sidebar code runs and the class never gets inserted.-->
+<script>$("li.active").parents('li').toggleClass("active");
+</script>
+
+            </div>
+            
+        
+
+        <!-- Content Column -->
+        <div class="col-md-9" id="tg-sb-content">
+            <div class="post-header">
+   <h1 class="post-title-main">Protocol specification for connections</h1>
+</div>
+
+
+
+<div class="post-content">
+
+   
+
+    
+    
+<!-- this handles the automatic toc. use ## for subheads to auto-generate the on-page minitoc. if you use html tags, you must supply an ID for the heading element in order for it to appear in the minitoc. -->
+<script>
+$( document ).ready(function() {
+  // Handler for .ready() called.
+
+$('#toc').toc({ minimumHeaders: 0, listType: 'ul', showSpeed: 0, headers: 'h2,h3,h4' });
+
+/* this offset helps account for the space taken up by the floating toolbar. */
+$('#toc').on('click', 'a', function() {
+  var target = $(this.getAttribute('href'))
+    , scroll_target = target.offset().top
+
+  $(window).scrollTop(scroll_target - 10);
+  return false
+})
+  
+});
+</script>
+
+<div id="toc"></div>
+
+    
+
+
+    
+
+
+    
+
+  <h2 id="ditto-protocol-topic-structure-for-connections">Ditto Protocol topic structure for connections</h2>
+
+<p>A valid topic consists of four elements, describing the connection affected by this message and the type of the message:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_/&lt;connectionId&gt;/connections/announcements/&lt;subject&gt;
+</code></pre></div></div>
+
+<ol>
+  <li><code class="highlighter-rouge">_</code>: empty field.</li>
+  <li><code class="highlighter-rouge">connectionId</code>: the ID of the connection.</li>
+  <li><code class="highlighter-rouge">group</code>: the group for addressing connections is <code class="highlighter-rouge">connections</code>.</li>
+  <li><code class="highlighter-rouge">criterion</code>: the type of protocol messages addressing connection <a href="basic-signals-announcement.html">announcements</a> is 
+<a href="protocol-specification-policies-announcement.html"><code class="highlighter-rouge">announcements</code></a>.</li>
+  <li><code class="highlighter-rouge">subject</code>: for <a href="basic-signals-announcement.html">announcements</a> the <code class="highlighter-rouge">subject</code> contains the announcement name</li>
+</ol>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The topic path of the <em>connections</em> group does not contain a namespace since there is 
+no correlation between namespaces and connections. Also there is no channel unlike the <em>things</em> group.</div>
+
+
+
+    <div class="tags">
+        
+        <b>Tags: </b>
+        
+        
+        
+        <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+        
+        
+        
+    </div>
+
+</div>
+
+<hr class="shaded"/>
+
+<footer>
+            <div class="row">
+                <div class="col-lg-12 footer">
+                    <div class="logo">
+                        <a href="https://eclipse.org"><img src="images/eclipse_foundation_logo.svg" alt="Eclipse logo"/></a>
+                    </div>
+                    <p class="notice">
+                        &copy;2021 Eclipse Ditto™.
+                         Site last generated: Jun 21, 2021 <br />
+                    </p>
+                    <div class="quickLinks">
+                        <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
+                            &gt; Privacy Policy
+                        </a>
+                        <a href="https://www.eclipse.org/legal/termsofuse.php" target="_blank">
+                            &gt; Terms of Use
+                        </a>
+                        <a href="https://www.eclipse.org/legal/copyright.php" target="_blank">
+                            &gt; Copyright Agent
+                        </a>
+                        <a href="https://www.eclipse.org/legal" target="_blank">
+                            &gt; Legal
+                        </a>
+                        <a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">
+                            &gt; License
+                        </a>
+                        <a href="https://eclipse.org/security" target="_blank">
+                            &gt; Report a Vulnerability
+                        </a>
+                    </div>
+                </div>
+            </div>
+</footer>
+
+
+        </div>
+    <!-- /.row -->
+</div>
+<!-- /.container -->
+</div>
+<!-- /#main -->
+    </div>
+
+</body>
+</html>
diff --git a/protocol-specification-errors.html b/protocol-specification-errors.html
index 290e9d0..c43f214 100644
--- a/protocol-specification-errors.html
+++ b/protocol-specification-errors.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1771,7 +1821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-announcement.html b/protocol-specification-policies-announcement.html
index 2af931c..61adcf9 100644
--- a/protocol-specification-policies-announcement.html
+++ b/protocol-specification-policies-announcement.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1798,7 +1848,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-create-or-modify.html b/protocol-specification-policies-create-or-modify.html
index a6d02bd..6f844cb 100644
--- a/protocol-specification-policies-create-or-modify.html
+++ b/protocol-specification-policies-create-or-modify.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2331,7 +2381,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-delete.html b/protocol-specification-policies-delete.html
index c0fe405..fee949f 100644
--- a/protocol-specification-policies-delete.html
+++ b/protocol-specification-policies-delete.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2001,7 +2051,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-retrieve.html b/protocol-specification-policies-retrieve.html
index 57dd876..b6915a1 100644
--- a/protocol-specification-policies-retrieve.html
+++ b/protocol-specification-policies-retrieve.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2224,7 +2274,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies.html b/protocol-specification-policies.html
index c17e790..1203255 100644
--- a/protocol-specification-policies.html
+++ b/protocol-specification-policies.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1840,7 +1890,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-create-or-modify.html b/protocol-specification-things-create-or-modify.html
index 77c8b0d..1fc4a65 100644
--- a/protocol-specification-things-create-or-modify.html
+++ b/protocol-specification-things-create-or-modify.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -3288,7 +3338,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-delete.html b/protocol-specification-things-delete.html
index a4ad05f..365eeb9 100644
--- a/protocol-specification-things-delete.html
+++ b/protocol-specification-things-delete.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2695,7 +2745,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-merge.html b/protocol-specification-things-merge.html
index 4895038..a3d2fd8 100644
--- a/protocol-specification-things-merge.html
+++ b/protocol-specification-things-merge.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2833,7 +2883,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-messages.html b/protocol-specification-things-messages.html
index 199de29..9a974cf 100644
--- a/protocol-specification-things-messages.html
+++ b/protocol-specification-things-messages.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2014,7 +2064,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-retrieve.html b/protocol-specification-things-retrieve.html
index 7e4d82e..26fb98c 100644
--- a/protocol-specification-things-retrieve.html
+++ b/protocol-specification-things-retrieve.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2587,7 +2637,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-search.html b/protocol-specification-things-search.html
index b3a7a13..a3ea1a5 100644
--- a/protocol-specification-things-search.html
+++ b/protocol-specification-things-search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2118,7 +2168,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things.html b/protocol-specification-things.html
index 9badab9..1d69182 100644
--- a/protocol-specification-things.html
+++ b/protocol-specification-things.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1842,7 +1892,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-topic.html b/protocol-specification-topic.html
index bc94403..98a0e0e 100644
--- a/protocol-specification-topic.html
+++ b/protocol-specification-topic.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1940,7 +1990,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification.html b/protocol-specification.html
index 38d4151..66fdf82 100644
--- a/protocol-specification.html
+++ b/protocol-specification.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1761,6 +1811,7 @@
 <ul>
   <li>See <a href="protocol-specification-things.html">specification for Things</a></li>
   <li>See <a href="protocol-specification-policies.html">specification for Policies</a></li>
+  <li>See <a href="protocol-specification-connections.html">specification for Connections</a></li>
 </ul>
 
 <h3 id="dittoProtocolResponse">Ditto Protocol response</h3>
@@ -1935,7 +1986,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-twinlive.html b/protocol-twinlive.html
index add92f2..dbbd4fb 100644
--- a/protocol-twinlive.html
+++ b/protocol-twinlive.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1781,7 +1831,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_010-M1.html b/release_notes_010-M1.html
index d60cdd9..3043d4e 100644
--- a/release_notes_010-M1.html
+++ b/release_notes_010-M1.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1760,7 +1810,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_010-M3.html b/release_notes_010-M3.html
index 61dc4f7..76da394 100644
--- a/release_notes_010-M3.html
+++ b/release_notes_010-M3.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_020-M1.html b/release_notes_020-M1.html
index d5f9ab6..3062faf 100644
--- a/release_notes_020-M1.html
+++ b/release_notes_020-M1.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1801,7 +1851,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_030-M1.html b/release_notes_030-M1.html
index 6ee3585..bd3e315 100644
--- a/release_notes_030-M1.html
+++ b/release_notes_030-M1.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1812,7 +1862,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_030-M2.html b/release_notes_030-M2.html
index 9872319..ae9910f 100644
--- a/release_notes_030-M2.html
+++ b/release_notes_030-M2.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1809,7 +1859,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M1.html b/release_notes_080-M1.html
index 3a9c687..1decd15 100644
--- a/release_notes_080-M1.html
+++ b/release_notes_080-M1.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1831,7 +1881,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M2.html b/release_notes_080-M2.html
index 1e99d3d..8be8774 100644
--- a/release_notes_080-M2.html
+++ b/release_notes_080-M2.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1815,7 +1865,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080-M3.html b/release_notes_080-M3.html
index de35761..3fafdb5 100644
--- a/release_notes_080-M3.html
+++ b/release_notes_080-M3.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1819,7 +1869,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_080.html b/release_notes_080.html
index 6bd9070..b4d1906 100644
--- a/release_notes_080.html
+++ b/release_notes_080.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1825,7 +1875,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090-M1.html b/release_notes_090-M1.html
index b5b97fd..d2bd95e 100644
--- a/release_notes_090-M1.html
+++ b/release_notes_090-M1.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1797,7 +1847,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090-M2.html b/release_notes_090-M2.html
index d104473..c4bdaf7 100644
--- a/release_notes_090-M2.html
+++ b/release_notes_090-M2.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1798,7 +1848,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_090.html b/release_notes_090.html
index 2ad61c9..19b6cb0 100644
--- a/release_notes_090.html
+++ b/release_notes_090.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1855,7 +1905,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100-M1a.html b/release_notes_100-M1a.html
index 25af2a7..9bd6c5c 100644
--- a/release_notes_100-M1a.html
+++ b/release_notes_100-M1a.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100-M2.html b/release_notes_100-M2.html
index ccaefee..07e3a56 100644
--- a/release_notes_100-M2.html
+++ b/release_notes_100-M2.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1833,7 +1883,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_100.html b/release_notes_100.html
index 1b1db48..dae6793 100644
--- a/release_notes_100.html
+++ b/release_notes_100.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1836,7 +1886,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_110.html b/release_notes_110.html
index 2943ee2..e7c4ad3 100644
--- a/release_notes_110.html
+++ b/release_notes_110.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1877,7 +1927,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_111.html b/release_notes_111.html
index 427f880..ba0c3fb 100644
--- a/release_notes_111.html
+++ b/release_notes_111.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1775,7 +1825,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_112.html b/release_notes_112.html
index b9debe3..f4b2bfc 100644
--- a/release_notes_112.html
+++ b/release_notes_112.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1791,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_113.html b/release_notes_113.html
index 4cc1bda..ce621d1 100644
--- a/release_notes_113.html
+++ b/release_notes_113.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1791,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_115.html b/release_notes_115.html
index abf50fd..cc463a7 100644
--- a/release_notes_115.html
+++ b/release_notes_115.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1779,7 +1829,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_120.html b/release_notes_120.html
index 3c4f0a9..a35dd53 100644
--- a/release_notes_120.html
+++ b/release_notes_120.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1851,7 +1901,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_121.html b/release_notes_121.html
index 5e1bd2c..28da251 100644
--- a/release_notes_121.html
+++ b/release_notes_121.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1778,7 +1828,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_130.html b/release_notes_130.html
index 5cf952e..ab36984 100644
--- a/release_notes_130.html
+++ b/release_notes_130.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1868,7 +1918,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_140.html b/release_notes_140.html
index fed5afb..ec10f48 100644
--- a/release_notes_140.html
+++ b/release_notes_140.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1845,7 +1895,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_150.html b/release_notes_150.html
index 9a6a5a9..5ad0867 100644
--- a/release_notes_150.html
+++ b/release_notes_150.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1879,7 +1929,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_151.html b/release_notes_151.html
index 065748a..313618e 100644
--- a/release_notes_151.html
+++ b/release_notes_151.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1767,7 +1817,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_200.html b/release_notes_200.html
index fc9b0cb..fb48041 100644
--- a/release_notes_200.html
+++ b/release_notes_200.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -2430,7 +2480,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_201.html b/release_notes_201.html
index 52f98a8..77ac6fa 100644
--- a/release_notes_201.html
+++ b/release_notes_201.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1791,7 +1841,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/sandbox.html b/sandbox.html
index 418c500..9784256 100644
--- a/sandbox.html
+++ b/sandbox.html
@@ -906,6 +906,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1058,7 +1065,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1093,6 +1100,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1635,6 +1664,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1816,7 +1866,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/search.json b/search.json
index 03c7273..385e774 100644
--- a/search.json
+++ b/search.json
@@ -411,6 +411,17 @@
 
 
 {
+"title": "HMAC signing",
+"tags": "connectivity",
+"keywords": "hmac, hmac-sha256, authorization, azure, aws, azure iot hub, azure service bus, azure monitor, aws version 4 signing, aws sns, signing",
+"url": "connectivity-hmac-signing.html",
+"summary": ""
+}
+,
+
+
+
+{
 "title": "Manage connections",
 "tags": "connectivity",
 "keywords": "",
@@ -910,6 +921,10 @@
 
 
 
+
+
+
+
 {
 "title": "Protocol examples",
 "tags": "protocol",
@@ -944,6 +959,28 @@
 
 
 {
+"title": "Connections - Announcement protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, announcement, connection, connections, connectivity",
+"url": "protocol-specification-connections-announcement.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification for connections",
+"tags": "protocol",
+"keywords": "protocol, specification, general, connection, connections, connectivity",
+"url": "protocol-specification-connections.html",
+"summary": ""
+}
+,
+
+
+
+{
 "title": "Protocol specification for errors",
 "tags": "protocol",
 "keywords": "protocol, specification, error, failure",
@@ -1488,6 +1525,16 @@
 
 
 {
+"title": "Support for HMAC-SHA256 signing for connections",
+"tags": "blogarchitectureconnectivityhmacazureazure iot hubazure service busazure monitoraws snssnsawssigningexample",
+"keywords": "",
+"url": "2021-06-17-hmac-credentials.html",
+"summary": ""
+}
+,
+
+
+{
 "title": "Announcing Eclipse Ditto Release 2.0.0",
 "tags": "blog",
 "keywords": "",
diff --git a/sitemap.xml b/sitemap.xml
index bb56923..da8ca87 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -3,6 +3,12 @@
   
   
   <url>
+    <loc>https://www.eclipse.org/ditto/2021-06-17-hmac-credentials.html</loc>
+  </url>
+  
+  
+  
+  <url>
     <loc>https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</loc>
   </url>
   
@@ -476,6 +482,12 @@
   
   
   <url>
+    <loc>https://www.eclipse.org/ditto/connectivity-hmac-signing.html</loc>
+  </url>
+  
+  
+  
+  <url>
     <loc>https://www.eclipse.org/ditto/connectivity-manage-connections.html</loc>
   </url>
   
@@ -825,6 +837,10 @@
   
   
   
+  
+  
+  
+  
   <url>
     <loc>https://www.eclipse.org/ditto/protocol-examples.html</loc>
   </url>
@@ -844,6 +860,18 @@
   
   
   <url>
+    <loc>https://www.eclipse.org/ditto/protocol-specification-connections-announcement.html</loc>
+  </url>
+  
+  
+  
+  <url>
+    <loc>https://www.eclipse.org/ditto/protocol-specification-connections.html</loc>
+  </url>
+  
+  
+  
+  <url>
     <loc>https://www.eclipse.org/ditto/protocol-specification-errors.html</loc>
   </url>
   
diff --git a/slides/2021_06_ditto-20-overview/index.html b/slides/2021_06_ditto-20-overview/index.html
new file mode 100644
index 0000000..09271bb
--- /dev/null
+++ b/slides/2021_06_ditto-20-overview/index.html
@@ -0,0 +1,398 @@
+<!--
+  ~ Copyright (c) 2021 Contributors to the Eclipse Foundation
+  ~
+  ~ See the NOTICE file(s) distributed with this work for additional
+  ~ information regarding copyright ownership.
+  ~
+  ~ This program and the accompanying materials are made available under the
+  ~ terms of the Eclipse Public License 2.0 which is available at
+  ~ http://www.eclipse.org/legal/epl-2.0
+  ~
+  ~ SPDX-License-Identifier: EPL-2.0
+  -->
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="utf-8">
+
+  <title>Eclipse Ditto™ 2.0: Changes and roadmap</title>
+
+  <meta name="description" content="Eclipse Ditto 2.0: Changes and roadmap">
+  <meta name="author" content="Thomas Jäckle">
+  <meta name="date" content="2021-06-22">
+  <meta http-equiv="content-language" content="en">
+
+  <meta name="apple-mobile-web-app-capable" content="yes">
+  <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+
+  <link rel="icon" type="image/png" href="../../images/favicon-16x16.png" sizes="16x16">
+  <link rel="icon" type="image/png" href="../../images/favicon-32x32.png" sizes="32x32">
+  <link rel="icon" type="image/png" href="../../images/favicon-96x96.png" sizes="96x96">
+
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=News+Cycle">
+  <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css"
+        integrity="sha384-DNOHZ68U8hZfKXOrtjWvjxusGo9WQnrNx2sqG0tfsghAvtVlRW3tvkXWZh58N9jp" crossorigin="anonymous">
+
+
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/reveal.min.css">
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/theme/simple.min.css"
+        id="theme">
+
+  <!-- Theme used for syntax highlighting of code -->
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/css/zenburn.min.css">
+
+  <style>
+    @font-face {
+      font-family: "News Cycle";
+    }
+
+    #header-left {
+      position: absolute;
+      top: 0%;
+      left: 0%;
+      opacity: 1 !important;
+    }
+
+    #header-right {
+      position: absolute;
+      top: 0%;
+      right: 0%;
+      opacity: 1 !important;
+    }
+
+    .reveal section img {
+      background: none;
+      border: none;
+      box-shadow: none;
+    }
+
+    .dim-background .slide-background {
+      opacity: 0.3 !important;
+      /*background: none !important;  for printing ! */
+      /* print with: file:///C:/...../index.html?print-pdf */
+    }
+
+    .chapter-background .slide-background {
+      opacity: 0.7 !important;
+      /*background: none !important;*/ /* for printing ! */
+    }
+
+    .print-pdf .reveal .slide-background {
+      opacity: 0.7 !important;
+    }
+
+    .dim-background .slide-background.past {
+      display: none !important;
+    }
+
+    .dim-background .slide-background.future {
+      display: none !important;
+    }
+
+    .chapter-background .slide-background.past {
+      display: none !important;
+    }
+
+    .chapter-background .slide-background.future {
+      display: none !important;
+    }
+
+    /*.new-chapter h3 { color: #586e75; }*/
+    .introlink a:link {
+      font-weight: bold;
+      color: #000000
+    }
+
+    /* unvisited links */
+    .introlink a:visited {
+      font-weight: bold;
+      color: #000000
+    }
+
+    /* visited links   */
+    .introlink a:hover {
+      font-weight: bold;
+      color: #000000
+    }
+
+    /* user hovers     */
+    .introlink a:active {
+      font-weight: bold;
+      color: #000000
+    }
+
+    ul {
+      list-style: none !important;
+    }
+
+    ul li {
+      padding-left: 1.3em;
+    }
+
+    ul li:before {
+      list-style: none;
+      content: "→";
+      display: inline-block;
+      margin-left: -1.3em; /* same as padding-left set on li */
+      width: 1.3em; /* same as padding-left set on li */
+    }
+
+    .footer {
+      font-size: 12px !Important;
+      font-family: "News Cycle", Impact, sans-serif;
+      color: #687175;
+      position: absolute;
+      bottom: 15px;
+      left: 15px;
+      margin-bottom: 10px
+    }
+
+    .footer a {
+      color: #003b6a;
+      text-decoration: none;
+    }
+
+    /* active links    */
+  </style>
+
+  <!-- Printing and PDF exports -->
+  <script>
+    var link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.type = 'text/css';
+    link.href =
+      window.location.search.match(/print-pdf/gi)
+      ? 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/pdf.min.css'
+      : 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/paper.min.css';
+    document.getElementsByTagName('head')[0].appendChild(link);
+  </script>
+
+  <!--[if lt IE 9]>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/html5shiv.js"></script>
+  <![endif]-->
+</head>
+
+<body>
+
+<div class="reveal">
+
+    <!-- 2. Create hidden header/footer <div> -->
+    <div id="hidden" style="display:none;">
+        <div id="header">
+            <div id="header-left"><img src="../../images/ditto.svg" style="width: 80px; padding-top: 10px; padding-left: 10px" alt="Ditto logo"></div>
+            <div id="header-right"><img src="../../images/iot_logo.svg" style="width: 120px; padding-top: 10px; padding-right: 10px" alt="Eclipse IoT logo"></div>
+        </div>
+    </div>
+
+    <!-- Any section element inside of this container is displayed as a slide -->
+    <div class="slides">
+        <!-- Section: Intro -->
+        <section>
+            <section id="title" class="new-chapter" data-background="../bg-images/background-twin-small.jpg" data-state="chapter-background">
+                <!-- background source: https://unsplash.com/collections/425779/iot -->
+              <h1 style="line-height: 1em">
+                <img src="../../images/iot_logo.svg" style="width: 15%;vertical-align: top; padding-right: 20px" alt="Eclipse IoT">
+                <img src="../../images/ditto.svg" style="width: 15%;vertical-align: middle" alt="Eclipse Ditto">
+              </h1>
+              <h1 style="margin-top: 0.6em; font-size: 2em;">Eclipse Ditto™ 2.0:<br/>Changes and roadmap</h1>
+              <h2 style="margin-top: 1.5em; font-size: 0.8em">06/2021</h2>
+            </section>
+        </section>
+
+        <!-- Section: Ditto -->
+        <section style="clear: both;">
+            <section id="ditto" style="clear: both;">
+                <h2>Eclipse Ditto in context</h2>
+              <div style="text-align: left; float: left; width: 65%">
+                <img src="../images/ditto-in-action-2020.png" style="width: 90%;padding-top:0.5em" alt="Ditto in action"/>
+              </div>
+              <p style="text-align: left; float: right; width: 35%; font-size: 0.8em">Ditto as <em>Digital Twin</em> "middleware"</p>
+              <ul style="text-align: left; float: right; width: 30%; font-size: 0.8em">
+                <li class="fragment" data-fragment-index="1" style="padding-top:0.5em">digital representation of real physical devices</li>
+                <li class="fragment" data-fragment-index="1" style="padding-top:0.5em">act as broker for communicating with assets</li>
+                <li class="fragment" data-fragment-index="1" style="padding-top:0.5em">consumer-centric & industrial IoT scenarios</li>
+              </ul>
+            </section>
+        </section>
+
+        <!-- Section: Ditto 2.0 -->
+        <section style="clear: both;">
+          <section id="ditto-20-1" style="clear: both;">
+            <h3>Breaking API changes (why 2.0)</h3>
+            <ul style="margin-top: 0.5em; font-size: 0.8em">
+              <li>Removal of “API version 1” and @Deprecated code</li>
+              <li style="margin-top: 0.5em;">Restructuring of Ditto’s Maven modules</li>
+            </ul>
+            <div class="fragment" data-fragment-index="1" style="margin-top: 1em;">
+              <h3>Non-functional enhancements</h3>
+              <ul style="margin-top: 0.5em; font-size: 0.8em">
+                <li>Improvement of stability during rolling updates</li>
+                <li style="margin-top: 0.5em;">Sharding concept for Ditto internal pub/sub</li>
+                <li style="margin-top: 0.5em;">Background cleanup improvements</li>
+              </ul>
+            </div>
+          </section>
+          <section id="ditto-20-2" style="clear: both;">
+            <h3>Functional enhancements</h3>
+            <ul style="margin-top: 0.5em; font-size: 0.8em">
+              <li class="fragment" data-fragment-index="1">Merge/PATCH updates of digital twins</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Expiring policy subjects and policy actions</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Built-in acknowledgement for search updates</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Establishing connections to endpoints via a SSH tunnel</li>
+              <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">Configurable OpenID Connect / OAuth2.0 claim extraction</li>
+              <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">Prioritized recovery of connections after restarts</li>
+              <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">Support for LastWill and retain flag for MQTT connections</li>
+              <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">Provide JWT tokens to Websocket endpoint with browser APIs</li>
+            </ul>
+          </section>
+        </section>
+
+        <!-- Section: Ditto roadmap -->
+        <section style="clear: both;">
+          <section id="ditto-roadmap-1" style="clear: both;">
+            <h3>Roadmap - Eclipse Ditto 2.1</h3>
+            <ul style="margin-top: 0.5em; font-size: 0.8em">
+              <li class="fragment" data-fragment-index="1">Full Apache Kafka integration</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Integration with Eclipse Hono via Apache Kafka</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Automatic creation of digital twins, e.g. when automatically created in Eclipse Hono via certificate based device auth</li>
+              <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Improvements around logging (e.g. into ELK stack or to file)</li>
+              <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">Support for HMAC based authentication methods, e.g. enabling additional
+                integration options for:
+                <ul>
+                  <li>Azure (HTTP Monitor Data Collector API, IoT Hub, Service Bus REST API)</li>
+                  <li>AWS (SNS, S3, <a href="https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html" target="_blank">other AWS services supporting Signature Version 4 signing</a>)</li>
+                </ul>
+              </li>
+            </ul>
+          </section>
+          <section id="ditto-roadmap-2" style="clear: both;">
+            <h3>Looking ahead</h3>
+            <ul style="margin-top: 0.5em; font-size: 0.8em">
+              <li>Tracing via OpenTelemetry</li>
+              <li style="margin-top: 0.5em;">Release of Go(lang) SDK</li>
+              <li style="margin-top: 0.5em;">Python SDK</li>
+              <li style="margin-top: 0.5em;">...</li>
+            </ul>
+          </section>
+        </section>
+
+        <!-- Section: Questions and Answers -->
+        <section style="clear: both;">
+            <section id="q-a" class="new-chapter" data-background="../bg-images/background-conclusion-small.jpg"
+                     data-state="chapter-background">
+                <br/>
+              <p>Links:</p>
+              <ul>
+                <li><a target="_blank" href="https://eclipse.org/ditto">Ditto website and documentation</a></li>
+                <li><a target="_blank" href="https://github.org/eclipse/ditto">GitHub</a> - please give us a star ;)</li>
+                <li><a target="_blank" href="https://gitter.im/eclipse/ditto">Chatroom to ask more questions</a></li>
+                <li><a target="_blank" href="https://developer.bosch-iot-suite.com/service/things/">Commercial offering incl. free plan</a></li>
+              </ul>
+            </section>
+        </section>
+    </div>
+
+</div>
+
+<div class="footer">
+    Copyright ©2021
+    <a href="https://www.bosch.io" target="_blank">Bosch.IO GmbH</a> All rights reserved. |
+    <a href="https://www.eclipse.org/ditto/intro-overview.html" target="_blank">Documentation</a> |
+    <a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a> |
+    <a href="https://ditto.eclipseprojects.io" target="_blank">Sandbox</a>
+</div>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/head.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/js/reveal.min.js"></script>
+
+<script>
+  function getParameterByName(name, url) {
+    if (!url) {
+      url = window.location.href;
+    }
+    name = name.replace(/[\[\]]/g, "\\$&");
+    var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"),
+      results = regex.exec(url);
+    if (!results) {
+      return null;
+    }
+    if (!results[2]) {
+      return '';
+    }
+    return decodeURIComponent(results[2].replace(/\+/g, " "));
+  }
+
+  // More info https://github.com/hakimel/reveal.js#configuration
+  Reveal.initialize({
+                      controls: true,
+                      progress: true,
+                      history: true,
+                      center: true,
+                      fragments: getParameterByName('fragments') === '', // only use "fragments" feature if queryParam 'fragments' is present
+                      slideNumber: 'h.v',
+
+                      transition: 'convex', // none/fade/cube/slide/convex/concave/zoom
+
+                      // More info https://github.com/hakimel/reveal.js#dependencies
+                      dependencies: [
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/classList.js',
+                          condition: function () {
+                            return !document.body.classList;
+                          }
+                        },
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/marked.js',
+                          condition: function () {
+                            return !!document.querySelector('[data-markdown]');
+                          }
+                        },
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/markdown.min.js',
+                          condition: function () {
+                            return !!document.querySelector('[data-markdown]');
+                          }
+                        },
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/highlight/highlight.min.js',
+                          async: true,
+                          callback: function () {
+                            hljs.initHighlightingOnLoad();
+                          }
+                        },
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/zoom-js/zoom.min.js',
+                          async: true
+                        },
+                        {
+                          src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/notes/notes.min.js',
+                          async: true
+                        }
+                      ],
+                      keyboard: { // for hama remote presenter:
+                        38: 'next',
+                        40: 'prev'
+                      }
+                    });
+
+</script>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
+<script type="text/javascript">
+  // 3. On Reveal.js ready event, copy header/footer <div> into each `.slide-background` <div>
+  var header = $('#header').html();
+  if (window.location.search.match(/print-pdf/gi)) {
+    Reveal.addEventListener('ready', function (event) {
+      $('.slide-background').append(header);
+    });
+  }
+  else {
+    $('div.reveal').append(header);
+  }
+</script>
+
+</body>
+</html>
diff --git a/tag_advanced.html b/tag_advanced.html
index e82bbee..3c6b41c 100644
--- a/tag_advanced.html
+++ b/tag_advanced.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1911,6 +1961,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2221,6 +2275,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2645,6 +2711,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2667,7 +2761,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_architecture.html b/tag_architecture.html
index 3eb39f8..4c283a2 100644
--- a/tag_architecture.html
+++ b/tag_architecture.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1947,6 +1997,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2257,6 +2311,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2499,6 +2565,40 @@
         
         
         
+
+        <tr><td><a href="2021-06-17-hmac-credentials.html">Support for HMAC-SHA256 signing for connections</a></td>
+            <td><span class="label label-primary">Post</span></td>
+            <td> With the upcoming release of Eclipse Ditto version 2.1.0 it will be possible to use HMAC-SHA256 signing for connections. The currently implemented algorithms support you in authenticating requests against:  Azure IoT Hub REST API Azure IoT Hub AMQP 1.0 Azure HTTP Monitor Data Collector API Azure Service Bus REST... </td>
+        </tr>
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         
         
         
@@ -2715,7 +2815,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_blog.html b/tag_blog.html
index 257b83a..2bcb56b 100644
--- a/tag_blog.html
+++ b/tag_blog.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2215,6 +2269,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2456,6 +2522,40 @@
         
         
 
+        <tr><td><a href="2021-06-17-hmac-credentials.html">Support for HMAC-SHA256 signing for connections</a></td>
+            <td><span class="label label-primary">Post</span></td>
+            <td> With the upcoming release of Eclipse Ditto version 2.1.0 it will be possible to use HMAC-SHA256 signing for connections. The currently implemented algorithms support you in authenticating requests against:  Azure IoT Hub REST API Azure IoT Hub AMQP 1.0 Azure HTTP Monitor Data Collector API Azure Service Bus REST... </td>
+        </tr>
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+
         <tr><td><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></td>
             <td><span class="label label-primary">Post</span></td>
             <td> Today, ~1.5 years after release 1.0.0, the Eclipse Ditto team is happy to announce the availability of Eclipse Ditto 2.0.0. With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated long ago in order to have a better maintainable... </td>
@@ -2907,7 +3007,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_client_sdk.html b/tag_client_sdk.html
index 044b379..737ced3 100644
--- a/tag_client_sdk.html
+++ b/tag_client_sdk.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1933,6 +1983,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2243,6 +2297,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2667,6 +2733,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2689,7 +2783,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_connectivity.html b/tag_connectivity.html
index 7aeebc0..02aca60 100644
--- a/tag_connectivity.html
+++ b/tag_connectivity.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1917,6 +1967,16 @@
     
         
 
+        <tr><td><a href="connectivity-hmac-signing.html">HMAC signing</a></td>
+            <td><span class="label label-default">Page</span></td>
+          <td> HMAC signing Ditto provides an extensible framework for HMAC-based signing authentication processes for HTTP Push and AMQP 1.0 connections. Three algorithms are available out of the box:  aws4-hmac-sha256 (HTTP Push only): Version 4 request signing for Amazon Web Services (AWS) az-monitor-2016-04-01 (HTTP Push only): &lt;a... </td>
+        </tr>
+        
+     
+   
+    
+        
+
         <tr><td><a href="connectivity-manage-connections.html">Manage connections</a></td>
             <td><span class="label label-default">Page</span></td>
           <td> In order to manage (CRUD) connections in Ditto DevOps commands have to be used. There is no separate HTTP API for managing the connections, as this is not a task for a developer using the digital twin APIs but more for a “DevOps engineer” creating new connections to external... </td>
@@ -1979,7 +2039,7 @@
 
         <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
             <td><span class="label label-default">Page</span></td>
-          <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note: HTTP... </td>
+          <td> Perform HTTP request (with verbs GET, POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note:... </td>
         </tr>
         
      
@@ -2305,6 +2365,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2555,6 +2627,40 @@
         
         
         
+
+        <tr><td><a href="2021-06-17-hmac-credentials.html">Support for HMAC-SHA256 signing for connections</a></td>
+            <td><span class="label label-primary">Post</span></td>
+            <td> With the upcoming release of Eclipse Ditto version 2.1.0 it will be possible to use HMAC-SHA256 signing for connections. The currently implemented algorithms support you in authenticating requests against:  Azure IoT Hub REST API Azure IoT Hub AMQP 1.0 Azure HTTP Monitor Data Collector API Azure Service Bus REST... </td>
+        </tr>
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
         
         
         
@@ -2793,7 +2899,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_getting_started.html b/tag_getting_started.html
index 85105ee..1718fe2 100644
--- a/tag_getting_started.html
+++ b/tag_getting_started.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2265,6 +2319,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2689,6 +2755,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2711,7 +2805,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_http.html b/tag_http.html
index 4cc429e..fdcc023 100644
--- a/tag_http.html
+++ b/tag_http.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2257,6 +2311,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2519,6 +2585,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
         <tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
             <td><span class="label label-primary">Post</span></td>
@@ -2709,7 +2803,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_installation.html b/tag_installation.html
index 7a7ca54..f6d3e80 100644
--- a/tag_installation.html
+++ b/tag_installation.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2233,6 +2287,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2657,6 +2723,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2679,7 +2773,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_model.html b/tag_model.html
index 1ba99ed..f94aad8 100644
--- a/tag_model.html
+++ b/tag_model.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1977,6 +2027,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2287,6 +2341,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2711,6 +2777,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2733,7 +2827,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_news.html b/tag_news.html
index 7c106f3..1e9b4a5 100644
--- a/tag_news.html
+++ b/tag_news.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2215,6 +2269,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2639,6 +2705,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2661,7 +2755,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_protocol.html b/tag_protocol.html
index 87b0861..cab930d 100644
--- a/tag_protocol.html
+++ b/tag_protocol.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1916,6 +1966,10 @@
    
     
         
+     
+   
+    
+        
 
         <tr><td><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></td>
             <td><span class="label label-default">Page</span></td>
@@ -1947,7 +2001,7 @@
 
         <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
             <td><span class="label label-default">Page</span></td>
-          <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note: HTTP... </td>
+          <td> Perform HTTP request (with verbs GET, POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note:... </td>
         </tr>
         
      
@@ -2281,6 +2335,10 @@
     
    
     
+   
+    
+   
+    
         
 
         <tr><td><a href="protocol-examples.html">Protocol examples</a></td>
@@ -2313,6 +2371,26 @@
     
         
 
+        <tr><td><a href="protocol-specification-connections-announcement.html">Connections - Announcement protocol specification</a></td>
+            <td><span class="label label-default">Page</span></td>
+          <td>  Note: The topic path of connection announcements contains a _ (underscore) as namespace and no channel element. See the specification for details.  Connection announcements A connection announcement contains the announcement name as last part of the topic: _/&lt;connectionId&gt;/connections/announcements/&lt;announcement-name&gt;... </td>
+        </tr>
+        
+     
+   
+    
+        
+
+        <tr><td><a href="protocol-specification-connections.html">Protocol specification for connections</a></td>
+            <td><span class="label label-default">Page</span></td>
+          <td> Ditto Protocol topic structure for connections A valid topic consists of four elements, describing the connection affected by this message and the type of the message: _/&lt;connectionId&gt;/connections/announcements/&lt;subject&gt;   _: empty field. connectionId: the ID of the connection. group: the group for addressing... </td>
+        </tr>
+        
+     
+   
+    
+        
+
         <tr><td><a href="protocol-specification-errors.html">Protocol specification for errors</a></td>
             <td><span class="label label-default">Page</span></td>
           <td> Ditto Protocol messages of error responses transport information about encountered errors, e.g. client errors or server errors:  The error codes Ditto provides in addition to the HTTP status code (e.g. error codes like “things:thing.tooLarge”) is not to be considered as API and must therefore not... </td>
@@ -2659,6 +2737,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
         <tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
             <td><span class="label label-primary">Post</span></td>
@@ -2847,7 +2953,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_release_notes.html b/tag_release_notes.html
index 0e4dde3..4eb82cc 100644
--- a/tag_release_notes.html
+++ b/tag_release_notes.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2215,6 +2269,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2807,6 +2873,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2829,7 +2923,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_rql.html b/tag_rql.html
index 73424bd..2df1a29 100644
--- a/tag_rql.html
+++ b/tag_rql.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1923,6 +1973,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -1957,7 +2011,7 @@
 
         <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
             <td><span class="label label-default">Page</span></td>
-          <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note: HTTP... </td>
+          <td> Perform HTTP request (with verbs GET, POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections &gt; Targets applies here as well. Following are some specifics for HTTP connections: Source format  Note:... </td>
         </tr>
         
      
@@ -2275,6 +2329,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2649,6 +2715,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
         <tr><td><a href="2018-09-21-selective-push-notifications.html">Selective push notifications available</a></td>
             <td><span class="label label-primary">Post</span></td>
@@ -2727,7 +2821,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_search.html b/tag_search.html
index d50f0ca..7b3f5fc 100644
--- a/tag_search.html
+++ b/tag_search.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1917,6 +1967,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2233,6 +2287,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2675,6 +2741,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2697,7 +2791,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_signal.html b/tag_signal.html
index 4f644b0..33298ee 100644
--- a/tag_signal.html
+++ b/tag_signal.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1946,6 +1996,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2256,6 +2310,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2680,6 +2746,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2702,7 +2796,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_troubleshooting.html b/tag_troubleshooting.html
index b764c43..4c93b82 100644
--- a/tag_troubleshooting.html
+++ b/tag_troubleshooting.html
@@ -904,6 +904,13 @@
               
               
               
+              
+              
+              <li><a href="connectivity-hmac-signing.html">HMAC signing</a></li>
+              
+              
+              
+              
           </ul>
         </li>
     
@@ -1056,7 +1063,7 @@
               
               
               <li class="subfolders">
-                  <a href="#"><span></span>→ commands/events</a>
+                  <a href="#"><span></span>→ commands/announcements</a>
                   <ul>
                       
                       
@@ -1091,6 +1098,28 @@
               
               
               
+              <li><a href="protocol-specification-connections.html">Connections group</a></li>
+              
+              
+              
+              <li class="subfolders">
+                  <a href="#"><span></span>→ announcements</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-specification-connections-announcement.html">Announcement</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
+              
+              
+              
               <li><a href="protocol-bindings.html">Bindings</a></li>
               
               
@@ -1633,6 +1662,27 @@
               
               
               
+              <li class="subfolders">
+                  <a href="#"><span></span>→ Connections examples</a>
+                  <ul>
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-opened.html">Announcement for connection opened</a></li>
+                      
+                      
+                      
+                      
+                      
+                      <li><a href="protocol-examples-connections-announcement-closed.html">Announcement for connection gracefully closed</a></li>
+                      
+                      
+                      
+                  </ul>
+              </li>
+              
+              
+              
               
               
               
@@ -1905,6 +1955,10 @@
     
         
      
+   
+    
+        
+     
         
      
         
@@ -2229,6 +2283,18 @@
     
    
     
+   
+    
+   
+    
+        
+     
+   
+    
+        
+     
+   
+    
         
      
    
@@ -2653,6 +2719,34 @@
         
         
         
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
+        
 
    </tbody>
 </table>
@@ -2675,7 +2769,7 @@
                     </div>
                     <p class="notice">
                         &copy;2021 Eclipse Ditto™.
-                         Site last generated: May 20, 2021 <br />
+                         Site last generated: Jun 21, 2021 <br />
                     </p>
                     <div class="quickLinks">
                         <a href="https://www.eclipse.org/legal/privacy.php" target="_blank">